Ingress启动失败主因是Ingress Controller未运行或Ingress规则未被正确加载，需依次排查：Controller Pod状态与日志、ingressClassName匹配与规则加载、Ingress语法语义错误、后端Service及Endpoint就绪性。
Ingress 启动失败或配置语法错误，通常不是 Ingress 资源本身“没启动”，而是它所依赖的 Ingress Controller 没跑起来，或者 Ingress 规则因格式/语义问题未被 Controller 正确加载。排查要聚焦两个核心：Controller 是否存活且就绪、Ingress 资源是否被识别并生效。
第一层：确认 Ingress Controller 的 Pod 状态和就绪性
很多问题卡在这一步——Ingress 资源写得再对，Controller 没运行，一切归零。
- 检查 Pod 是否处于 Running 状态，且 READY 列为 1/1（或对应副本数）：
kubectl get pods -n ingress-nginx（命名空间依实际安装而定，如kube-system或 Helm 自定义） - 若状态为
CrashLoopBackOff或0/1READY，说明 Controller 启动失败或探针不通过；重点看RESTARTS是否持续增长 - 立即查日志定位原因：
kubectl logs -n ingress-nginx <pod-name> --tail=100
常见 Controller 启动失败原因包括：
– ValidatingWebhookConfiguration 引用了一个不存在的 admission service
– ConfigMap（如 nginx-configuration）中存在 YAML 语法错误，导致 Nginx reload 失败
– 节点资源不足被驱逐，或 kubelet 通信异常
第二层：验证 Ingress Controller 是否加载了你的规则
Ingress 资源创建成功 ≠ 被 Controller 接管。关键要看 ingressClassName 是否匹配，以及 Controller 是否监听该类。
- 检查你的 Ingress YAML 中是否明确指定了
ingressClassName，例如：ingressClassName: nginx；若未指定，需确认集群默认 IngressClass 是否存在且启用 - 查看 Controller 日志中是否有类似
successfully validated configuration或reloading NGINX的提示；若完全无相关日志，大概率规则未被识别 - 临时加个简单规则（如 host 为
test.local），用curl -H "Host: test.local" http://<controller-ip>直连测试，绕过 DNS 和 LB，验证 Controller 是否能响应
第三层：检查 Ingress 资源本身的语法与语义错误
YAML 格式错误（缩进、冒号、引号）或字段逻辑冲突，会导致资源创建失败或被忽略。
- 用
kubectl apply --dry-run=client -o yaml -f your-ingress.yaml预检语法，避免直接提交报错 - 创建后执行
kubectl get ingress -n <ns> -o wide，观察ADDRESS列是否为空；长期为空常意味着规则未被 Controller 加载 - 检查事件：
kubectl describe ingress <name> -n <ns>，留意 Events 区域是否有FailedAttachVolume、Invalid rule或Missing Service类提示 - 特别注意字段拼写：如
http下必须是paths（复数），每个 path 必须含pathType（Exact/Prefix/ImplementationSpecific），service 名和端口名必须与真实 Service 完全一致
第四层：交叉验证 Service 与 Endpoint 是否就绪
即使 Controller 运行正常、Ingress 语法无误，若后端 Service 没匹配到 Pod，仍会返回 503。
- 确认 Service 存在且 selector 能匹配目标 Pod 的 labels：
kubectl get svc <svc-name> -n <ns> -o yaml - 检查 Endpoint 是否有地址：
kubectl get endpoints <svc-name> -n <ns>；若为空，说明没有 Pod 处于 Ready 状态 - 进一步确认 Pod 状态：
kubectl get pods -n <ns> -l <selector-labels>，确保 READY 列为1/1且 STATUS 是Running
