Pod 显示 Ready,健康探针也成功,但经 Ingress 访问仍返回 502,这并不必然意味着探针失效。探针验证的是特定时间、特定路径和特定网络位置上的应用响应;Ingress 转发则依赖规则选中的 Service、端口映射、可用端点,以及代理到端点的实际连接。任何一层的配置或状态不一致,都可能让健康的 Pod 无法成为这次请求的有效上游。🔎
排查主线:按照“Ingress 后端引用 → Service 端口映射 → EndpointSlice 端点 → 代理上游连接结果”建立同一条证据链。Pod 的 Ready 状态只是其中一项证据,不能替代对代理实际连接目标的核对。
先确认请求命中的 Ingress 规则、命名空间、路径匹配结果,以及规则引用的 Service 名称和端口。需要区分 Service 的 port 与 targetPort:前者是 Service 暴露给集群内客户端使用的端口,后者指定流量如何映射到 Pod 端口。若使用命名端口,应检查 Service 中的端口名称与 Pod 容器端口声明能正确对应。还要比较端口协议和应用实际监听方式;HTTP 与 HTTPS 配置不匹配时,即使 TCP 连接建立,也可能因协议握手或响应无法解析而失败。⚙️
不要把“清单里有一个端口”当作监听证明。应用可能只绑定回环地址、启动后才开始监听,或者容器端口声明与进程监听配置不一致。检查配置与运行状态时,应记录实际后端端口和协议,供后续与端点及代理日志比对。
EndpointSlice 描述 Service 当前关联的端点地址、端口和状态。首先验证 Service selector 是否能选中预期 Pod,再检查切片里记录的地址是否属于这些 Pod,端口是否是映射后的后端端口,协议是否符合预期。随后结合 ready、serving、terminating 条件判断端点是否可供当前流量策略使用。不同控制器和集群版本对终止端点的处理可能不同,应按现场配置和行为验证。📍
切片为空,可能是选择器不匹配或没有满足条件的端点;切片里端口缺失或不正确,可能来自端口名称映射;地址仍指向已经退出的 Pod,则要核对发布、终止和控制面更新的时间线。端点存在只说明控制面公布了地址,不证明目标进程正在监听,也不证明代理已经同步到最新状态。
将故障请求与同一时间窗口的访问日志、控制器错误日志关联。优先收集请求标识、路径、上游地址与端口、上游状态码、连接耗时、响应耗时,以及错误摘要。若当前日志没有这些字段,应先确认该 Ingress 实现可提供哪些既有记录,再按字段实际含义分析,避免假设不同控制器的日志格式完全相同。📊
关键问题是:代理尝试连接了哪个端点、使用什么端口和协议、连接在哪个阶段失败?用具体上游记录回答,才能区分端点发现问题与网络或应用层问题。
port、targetPort、端口名称和协议。验收标准:请求不再返回 502;代理日志中的上游属于预期可服务端点;拒绝、超时或重置等连接错误不再持续增加;发布或滚动更新期间,切片状态和连接目标的变化也符合预期。用连续观测完成验收,不以单次成功请求作为结案依据。🎯
常见误区包括把 Pod Ready 等同于应用端口可从代理侧访问、看到 Service 有端点就认为代理已同步、把所有 502 都归因于应用内部错误,以及忽略协议差异和故障发生时间。排查应把控制面公布的目标与数据面真实尝试连接的目标分开核实,再按失败阶段缩小范围。🧪
完成“规则与 Service 端口、EndpointSlice 地址与状态、代理上游连接记录”三方比对后,问题通常可归入配置映射、端点发现、网络连通或应用协议。最终用修复后的端点和连接记录验证链路闭环,既能解释为什么 Pod 健康时仍会 502,也能降低因误判而改动无关配置的风险。✅