首页/云/Kubernetes 速查/准入 Webhook 故障
集群运维与排障54 条

准入 Webhook 故障

准入控制器配置不可用时,创建与更新资源会直接失败:报错文本会指出是哪个 Webhook 拒绝或调用失败,据此定位服务与端点。

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

排查

排查
kubectl get validatingwebhookconfigurations,mutatingwebhookconfigurations
kubectl get svc -n webhook-system
kubectl get endpoints -n webhook-system webhook-svc
kubectl describe validatingwebhookconfiguration my-policy | tail -20

典型报错

典型报错
Error from server: error when creating "pod.yaml": admission webhook
"validate.example.com" denied the request: ...
(或) failed calling webhook ...: Post "https://...:443/validate": dial tcp ...: connect: connection refused
failurePolicy=Fail 时 Webhook 不可用会阻塞写入,Ignore 则放行但失去校验;变更策略前先评估这两者的影响。

易错点

  • 服务端点为空仍反复看策略:先确认 Service 选择器与端口是否匹配 Pod
  • 把 failurePolicy 改成 Ignore 图省事:等于绕过策略校验,修好后要恢复并记录变更

数据来源与参考

  • Kubernetes 官方文档 · 动态准入控制
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌