容器与云原生 / 系统课时
识别 Service 与 Ingress 的边界
识别 Service 与 Ingress 的边界
本课解决排障中最常见的方向错误:把域名、URL 路径、TLS 和后端连通问题混在一起处理。学完后,你能按职责边界判断故障更接近入口路由、Service 后端选择还是 Pod,并用最小命令链逐层验证。
学习目标
- 区分 Service 与 Ingress 的职责,不用简单的“四层/七层”标签替代判断
- 根据现象选择优先检查 Ingress、Service、EndpointSlice 或入口控制器
- 用最小命令链验证 Ingress 引用的 Service 是否拥有可用后端
两者分别解决什么问题
Service 的核心职责是为一组工作负载提供稳定的服务访问抽象,并通过 Service 与 EndpointSlice 等对象描述可用后端。它可以承载 HTTP、数据库连接等多种流量,但 Service 本身不会按 HTTP Host 或 URL Path 选择后端。因此,把 Service 简称为“四层”只能作为入门近似,排障时更应关注“这个 Service 指向哪些端点、端口如何映射”。
Ingress 是面向 HTTP/HTTPS 的路由 API,可按 Host、Path 等规则把请求交给不同的后端 Service。真正接收请求并执行这些规则的是 Ingress Controller,所以创建 Ingress 对象并不等于入口已经可达,也不代表后端一定健康。

用现象决定排查方向
先判断请求在哪一层已经成功,再检查它的下一跳。TLS 握手失败、Host 或 Path 未命中预期规则时,优先检查入口地址、Ingress 配置和 Ingress Controller;如果已确认请求被路由到目标 Service,却没有可用后端或端口不匹配,再转向 Service、EndpointSlice 和 Pod。
| 现象 | 优先检查 |
|---|---|
404 或路径命中错误 |
Ingress Host、Path、Controller,并确认响应是否实际来自应用 |
| Host 被路由到错误后端 | Ingress 规则与对应 Controller |
| TLS 握手或证书异常 | 入口监听、Ingress TLS 配置、Controller |
| Service 没有可用端点 | Service selector、EndpointSlice、Pod 标签与就绪状态 |
| Service 后端端口不通 | Service port、targetPort、Pod 实际监听端口 |
这里的“优先”不是排除其他层。例如 404 既可能来自 Ingress Controller 的默认处理,也可能来自后端应用;而 EndpointSlice 没有可用端点时,则没有必要先反复修改 Host 或 Path。
用最小命令链分层定位
假设 Ingress 名为 app,其规则应把 app.example.test 转发到当前命名空间的 web Service。先查看 Ingress 解析结果,再核对 Service 与 EndpointSlice,可以快速判断“入口规则是否引用了正确服务”和“这个服务是否真的有可用后端”。
kubectl describe ingress app
kubectl get svc web
kubectl get endpointslice -l kubernetes.io/service-name=web预期输出(关注关键字段,实际列、地址、名称和时间会因环境而不同):
Rules:
Host Path Backends
app.example.test / web:80 (<IP>:8080)
NAME TYPE CLUSTER-IP PORT(S)
web ClusterIP <IP> 80/TCP
NAME ADDRESSTYPE PORTS ENDPOINTS
web-<ID> IPv4 8080 <IP>如果 Ingress 已正确引用 web:80,且 EndpointSlice 中存在预期端点,但外部请求仍发生 Host、Path、TLS 或入口连接异常,应继续检查 Ingress Controller 的监听状态、配置和日志。如果 EndpointSlice 为空,则优先检查 Service selector、Pod 标签、Pod 就绪状态以及 targetPort 与应用监听端口,修复后再回到入口层验证。
一个请求跨过哪些边界
从逻辑关系看,典型 HTTP 请求先到达入口数据面,Ingress 规则决定应把请求交给哪个 Service,Service 再描述这组工作负载对应哪些后端端点。这里实际上是两个问题:入口规则选择哪个服务,以及这个服务当前有哪些可用后端。
但不要把这条逻辑关系机械理解为数据包一定经过 Ingress Controller → ClusterIP → Pod。不同 Controller 的数据面实现不同,有的会读取 Service 与 EndpointSlice 后直接代理到 Pod。排障时应关注 Kubernetes 对象之间的引用、Controller 的实际行为和当前端点,而不是假设固定的内部转发路径。
常见边界误判
最典型的误判是把 404 直接当成 Service 没找到 Pod。404 表明某个 HTTP 处理节点已经返回响应,但返回者可能是入口控制器,也可能是后端应用,因此还要结合 Controller 日志、响应特征和路由目标判断来源。
另一个误判是看到 Service 有 ClusterIP 就认为后端一定可用。ClusterIP 只说明 Service 获得了稳定入口,真正能否处理请求还取决于 EndpointSlice、Pod 就绪状态、端口映射和应用监听。实际排障应沿着“入口监听与规则 → Service 引用 → EndpointSlice → Pod”逐层收集证据,避免跨层猜测。