首页/云/Kubernetes 速查/API 请求被限流(429)
集群运维与排障54 条

API 请求被限流(429)

apiserver 具备流控与优先级机制:短时 429 多来自某个客户端并发过高,持续 429 说明请求量已超出集群处理能力。

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

观察限流

观察限流
kubectl get --raw /metrics | grep -E 'apiserver_flowcontrol_(rejected_requests_total|current_executing_seats)' | head
kubectl logs -n kube-system kube-apiserver-node1 | grep -i '429' | tail -20
kubectl get --raw /healthz?verbose | head -20
客户端可通过降低并发、设置请求超时与限速参数缓解;排查时优先找频繁 list/watch 全量资源的控制器。

易错点

  • 直接调大 apiserver 并发上限:不定位来源只是把压力往后传
  • 忽略客户端默认限速:SDK 默认 QPS 偏低,控制器密集型场景容易自身就限速

数据来源与参考

  • Kubernetes 官方文档 · API 优先级与公平性(APF)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌