在线客服

Ingress 返回 502 且 Pod 健康:逐项核对服务端口、端点切片与上游连接

⏱️2026-10-23 23:01 👁️1

🧭 Ingress 502 且 Pod 健康:从服务入口追到代理上游

Pod 显示 Ready,健康探针也成功,但经 Ingress 访问仍返回 502,这并不必然意味着探针失效。探针验证的是特定时间、特定路径和特定网络位置上的应用响应;Ingress 转发则依赖规则选中的 Service、端口映射、可用端点,以及代理到端点的实际连接。任何一层的配置或状态不一致,都可能让健康的 Pod 无法成为这次请求的有效上游。🔎

排查主线:按照“Ingress 后端引用 → Service 端口映射 → EndpointSlice 端点 → 代理上游连接结果”建立同一条证据链。Pod 的 Ready 状态只是其中一项证据,不能替代对代理实际连接目标的核对。

一、先确认 Service 端口和协议映射

先确认请求命中的 Ingress 规则、命名空间、路径匹配结果,以及规则引用的 Service 名称和端口。需要区分 Service 的 port 与 targetPort:前者是 Service 暴露给集群内客户端使用的端口,后者指定流量如何映射到 Pod 端口。若使用命名端口,应检查 Service 中的端口名称与 Pod 容器端口声明能正确对应。还要比较端口协议和应用实际监听方式;HTTP 与 HTTPS 配置不匹配时,即使 TCP 连接建立,也可能因协议握手或响应无法解析而失败。⚙️

不要把“清单里有一个端口”当作监听证明。应用可能只绑定回环地址、启动后才开始监听,或者容器端口声明与进程监听配置不一致。检查配置与运行状态时,应记录实际后端端口和协议,供后续与端点及代理日志比对。

二、检查 EndpointSlice 中实际可用的端点

EndpointSlice 描述 Service 当前关联的端点地址、端口和状态。首先验证 Service selector 是否能选中预期 Pod,再检查切片里记录的地址是否属于这些 Pod,端口是否是映射后的后端端口,协议是否符合预期。随后结合 ready、serving、terminating 条件判断端点是否可供当前流量策略使用。不同控制器和集群版本对终止端点的处理可能不同,应按现场配置和行为验证。📍

切片为空,可能是选择器不匹配或没有满足条件的端点;切片里端口缺失或不正确,可能来自端口名称映射;地址仍指向已经退出的 Pod,则要核对发布、终止和控制面更新的时间线。端点存在只说明控制面公布了地址,不证明目标进程正在监听,也不证明代理已经同步到最新状态。

三、用代理上游记录判断失败发生在哪一步

将故障请求与同一时间窗口的访问日志、控制器错误日志关联。优先收集请求标识、路径、上游地址与端口、上游状态码、连接耗时、响应耗时,以及错误摘要。若当前日志没有这些字段,应先确认该 Ingress 实现可提供哪些既有记录,再按字段实际含义分析,避免假设不同控制器的日志格式完全相同。📊

  • 没有可用上游:检查端点是否为空、是否被就绪条件排除,以及代理是否已观察到切片更新。
  • 连接被拒绝:将日志中的上游地址和端口与切片对照,继续检查 Pod 上的监听地址、端口及应用启动状态。
  • 连接超时:核对路由、网络策略及后端负载;区分建立连接耗时和等待响应耗时,不要把它们混成一种故障。
  • 连接后被重置或响应无法解析:检查应用是否提前关闭连接、是否发生 HTTP/HTTPS 或 TLS 配置错配,以及代理期望的响应协议。
关键问题是:代理尝试连接了哪个端点、使用什么端口和协议、连接在哪个阶段失败?用具体上游记录回答,才能区分端点发现问题与网络或应用层问题。

四、按顺序实施诊断并验证修复

  1. 固定现场:记录故障时间范围、命中的规则、请求路径和请求标识,并保存当时的 Service、EndpointSlice 与相关日志状态。
  2. 比对引用:确认 Ingress 后端名称、命名空间与端口引用准确,随后核对 Service selector、port、targetPort、端口名称和协议。
  3. 比对端点:检查 EndpointSlice 的地址、端口、协议及条件状态,并把地址与预期 Pod 对应起来。
  4. 比对连接:将代理日志中的实际上游地址、端口和错误阶段与切片逐项对照;每次只验证一个假设,避免同时改动多层配置。
  5. 复核结果:配置修正后等待相关状态传播,再用可重复请求观察多次访问和端点变化。

验收标准:请求不再返回 502;代理日志中的上游属于预期可服务端点;拒绝、超时或重置等连接错误不再持续增加;发布或滚动更新期间,切片状态和连接目标的变化也符合预期。用连续观测完成验收,不以单次成功请求作为结案依据。🎯

五、常见误区与结论

常见误区包括把 Pod Ready 等同于应用端口可从代理侧访问、看到 Service 有端点就认为代理已同步、把所有 502 都归因于应用内部错误,以及忽略协议差异和故障发生时间。排查应把控制面公布的目标与数据面真实尝试连接的目标分开核实,再按失败阶段缩小范围。🧪

完成“规则与 Service 端口、EndpointSlice 地址与状态、代理上游连接记录”三方比对后,问题通常可归入配置映射、端点发现、网络连通或应用协议。最终用修复后的端点和连接记录验证链路闭环,既能解释为什么 Pod 健康时仍会 502,也能降低因误判而改动无关配置的风险。✅

鲨鱼云自助平台

鲨鱼云自助平台是一站式国际云服务解决方案平台,支持阿里云国际、腾讯云国际、亚马逊AWS、谷歌云GCP等主流云厂商账号的开通、充值与管理。

热门文章
更多>