Kubernetes水平Pod自动扩缩容(HPA)无法正常工作求助

核心问题原因 #

• Metrics Server配置异常：常见为自签名证书不被信任、kubelet地址配置错误、权限不足，导致无法从kubelet采集节点/容器指标
• Pod未配置CPU请求：HPA基于CPU使用率阈值扩缩容，但Pod未设置resources.requests.cpu时，Metrics Server不会采集该Pod的CPU指标
• Metrics Server Pod隐性故障：虽状态显示Running，但日志中可能存在连接kubelet失败、证书验证错误等问题
• 集群网络阻塞：Metrics Server与kubelet、API Server与Metrics Server之间的网络不通

分步解决方法 #

1. 补全Pod的CPU请求配置 #

HPA依赖Pod的CPU请求值计算使用率，必须在Deployment的Pod模板中添加resources.requests.cpu配置：

spec:
  containers:
  - name: spring-boot-app
    image: your-app-image:tag
    resources:
      requests:
        cpu: "100m"  # 必填，否则Metrics Server不采集该Pod的CPU指标
      limits:
        cpu: "500m"

更新Deployment后等待Pod重建，再检查HPA状态。

2. 排查Metrics Server运行日志 #

查看Metrics Server的Pod日志定位具体报错：

kubectl logs -n kube-system deployment/metrics-server

针对常见报错的修复：

• x509证书信任问题：测试环境可在Metrics Server启动参数中添加--kubelet-insecure-tls跳过验证，生产环境需配置可信证书：

  args:
    - --cert-dir=/tmp
    - --secure-port=4443
    - --kubelet-preferred-address-types=InternalIP
    - --kubelet-insecure-tls  # 添加该行跳过kubelet证书验证
  

• kubelet连接失败：调整--kubelet-preferred-address-types参数为InternalIP，避免使用Hostname导致解析失败。

3. 验证Metrics Server API注册状态 #

确认API Server已成功注册Metrics Server的API：

kubectl api-versions | grep metrics

需返回metrics.k8s.io/v1beta1或v1beta2，若未返回则检查RBAC权限配置：

kubectl describe clusterrolebinding metrics-server:system:auth-delegator

确保ClusterRoleBinding绑定了具备kubelet指标访问权限的ClusterRole。

4. 直接测试Metrics Server API可用性 #

通过API调用验证指标采集是否正常：

kubectl get --raw "/apis/metrics.k8s.io/v1beta1/nodes"

若返回超时则排查网络连通性，返回权限错误则调整RBAC配置。

5. 检查HPA配置与状态 #

查看HPA的详细运行状态，确认指标采集情况：

kubectl describe hpa your-hpa-name

若显示failed to get cpu utilization: unable to get metrics for resource cpu: metrics not available，优先解决前面的Metrics Server和Pod CPU请求配置问题。

内容的提问来源于stack exchange，提问作者MsA