首页/云/Kubernetes 速查/HPA 不扩容的排查顺序
本包目录(307 条)
kubectl 基础56 条工作负载36 条网络与服务55 条配置与存储54 条
调度与资源52 条
集群运维与排障54 条

HPA 不扩容的排查顺序

按「指标 → 当前副本 → 上限 → 目标值」逐层核对:指标 Unknown、已达 maxReplicas、就绪副本不足,都表现为「不动」。

Kubernetes 速查云更新于 2026-10-12

排查命令

排查命令
kubectl get hpa -A
kubectl describe hpa web-hpa | sed -n '/Conditions:/,/Events:/p'
kubectl top pod -l app=web --sum
kubectl get deploy web -o jsonpath='{.spec.replicas} {.status.readyReplicas}'

现象

现象常见原因
TARGETS 显示 unknown指标管道异常,或容器未定义 requests
副本已等于 maxReplicas上限封顶,需调大上限或改指标
扩容后利用率仍高于目标新副本未就绪(readiness 慢)或流量持续上涨
副本来回摆动稳定窗口太短或指标本身抖动大

易错点

  • 只看 get hpa 的数值:Conditions 与 Events 里有更具体的失败原因
  • 扩容未见效先核对就绪状态:未 Ready 的副本不计入有效容量

数据来源与参考

  • Kubernetes 官方文档 · HPA 故障与事件
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌