容器与云原生 / 系统课时
识别无端点的 Service
识别无端点的 Service
本课解决的是“Service 看起来正常,但 EndpointSlice 没有可用后端”时如何快速定性。重点不再重复完整的 Service→Pod 检查链,而是先用 EndpointSlice 的地址与条件判断故障属于发现、就绪还是端口解析,再只对命中的分支补证据。
学习目标
- 能用 EndpointSlice 的地址与 conditions 区分“无地址”和“已有地址但不可服务”。
- 能在 selector 已匹配 Pod 时继续识别命名 targetPort、Pod IP 等导致端点缺失的原因。
- 能根据证据决定修 selector、修端口定义,还是转向就绪状态与网络路径排查。
先按 EndpointSlice 证据分类
对于带 selector 的普通 Service,EndpointSlice 是判断“后端地址有没有形成”的直接证据。先看切片中是否存在地址,再看 ready、serving、terminating,比从 Service、Pod 重新顺序排查更快。
| 现场证据 | 结论 | 下一步 |
|---|---|---|
| 没有 EndpointSlice,或切片没有任何地址 | 真正的“无端点”候选 | 检查 selector、Pod IP、命名 targetPort 解析 |
有地址,但 ready=false |
后端已被发现,不是“无端点” | 检查 Pod Ready、readiness probe、终止状态 |
| 有地址且条件正常,请求仍失败 | 服务发现已完成 | 转向应用监听、端口映射、NetworkPolicy、kube-proxy 或 CNI |
Service 没有 .spec.selector 时,控制面不会根据 Pod 自动维护 EndpointSlice;ExternalName 则通过 DNS CNAME 工作。这两类对象即使没有由 Pod 自动生成的端点,也不能直接判定为服务发现故障。
如果 Service 设置了 publishNotReadyAddresses: true,端点就绪条件的解释会不同,不能仅凭 ready 判断 Pod 的真实就绪状态;此时还要回看 Pod 自身状态与 Service 配置。

一次采集只回答三个问题
下面的命令只围绕三个问题取证:Service 是否自动选 Pod、是否有匹配 Pod、EndpointSlice 是否形成地址。将占位符替换为现场值;<SELECTOR> 使用 Service 的完整 selector,例如 app=api,tier=backend。
NAMESPACE='<NAMESPACE>'
SERVICE_NAME='<SERVICE_NAME>'
SELECTOR='<SELECTOR>'
kubectl -n "$NAMESPACE" get svc "$SERVICE_NAME" -o jsonpath='type={.spec.type}{"\t"}selector={.spec.selector}{"\t"}publishNotReady={.spec.publishNotReadyAddresses}{"\n"}{range .spec.ports[*]}port={.port}{"\t"}targetPort={.targetPort}{"\n"}{end}'
kubectl -n "$NAMESPACE" get pods -l "$SELECTOR" -o wide --show-labels
kubectl -n "$NAMESPACE" get endpointslice -l kubernetes.io/service-name="$SERVICE_NAME" -o wide
kubectl -n "$NAMESPACE" get endpointslice -l kubernetes.io/service-name="$SERVICE_NAME" -o jsonpath='{range .items[*].endpoints[*]}address={.addresses[0]}{"\t"}ready={.conditions.ready}{"\t"}serving={.conditions.serving}{"\t"}terminating={.conditions.terminating}{"\n"}{end}'预期输出(以下示例表示 selector 没有匹配任何 Pod,因此切片中也没有后端地址;实际名称、时间和 ID 会不同):
type=ClusterIP selector=map[app:api] publishNotReady=false
port=80 targetPort=8080
No resources found in <NAMESPACE> namespace.
NAME ADDRESSTYPE PORTS ENDPOINTS AGE
<SERVICE_NAME>-<ID> IPv4 8080 <none> <TIME>最后一条 JSONPath 命令在没有 endpoint 时不会输出任何行。不同版本和协调时机下,也可能暂时看不到对应 EndpointSlice;关键判断仍是“当前没有任何后端地址”,而不是某个固定的表格形态。
无地址时只检查会阻止端点形成的条件
如果 selector 根本匹配不到 Pod,优先比较 Service 的 .spec.selector 与目标 Pod labels,检查键、值、大小写和命名空间。修正 selector 或 Pod 标签后,EndpointSlice 控制器会重新协调,不要手工编辑自动管理的切片。
如果 selector 已经匹配 Pod,却仍没有地址,就不要把“控制器坏了”当作唯一解释。至少继续核对两类会阻断端点形成的条件:Pod 是否拥有可用的 Pod IP,以及 Service 使用命名 targetPort 时,该名称是否真的存在于目标 Pod 的容器端口中。数值型 targetPort 即使指错应用实际监听端口,通常也不会让已经匹配到的 Pod 地址消失;它更常表现为端点存在但连接失败。
下面只在 targetPort 是名称时使用,用于核对 Pod 实际声明的端口名。
NAMESPACE='<NAMESPACE>'
SELECTOR='<SELECTOR>'
kubectl -n "$NAMESPACE" get pods -l "$SELECTOR" -o jsonpath='{range .items[*]}pod={.metadata.name}{"\t"}podIP={.status.podIP}{"\t"}{range .spec.containers[*].ports[*]}{.name}{":"}{.containerPort}{" "}{end}{"\n"}{end}'预期输出:
pod=<POD_NAME> podIP=<POD_IP> http:8080如果 Service 写的是 targetPort: web,而 Pod 只声明了 http:8080,应修正端口名使两边一致;如果 Pod 没有 Pod IP,则应先处理 Pod 本身的调度、网络或生命周期问题。
地址已经存在就停止排查“无端点”
EndpointSlice 已有 Pod IP 时,说明发现链已经完成。此时 ready=false 应转向 Pod Ready、readiness probe、终止状态,以及 ready、serving、terminating 条件的组合,而不是继续修改 selector。
修复后重新查看 EndpointSlice,验收标准是切片出现预期 Pod IP;用于普通流量的后端还应满足当前 Service 配置下的可服务条件。
NAMESPACE='<NAMESPACE>'
SERVICE_NAME='<SERVICE_NAME>'
kubectl -n "$NAMESPACE" get endpointslice -l kubernetes.io/service-name="$SERVICE_NAME" -o wide预期输出:
NAME ADDRESSTYPE PORTS ENDPOINTS AGE
<SERVICE_NAME>-<ID> IPv4 8080 <POD_IP> <TIME>识别无端点故障的关键是先回答“EndpointSlice 里到底有没有地址”。没有地址时只追查会阻止端点形成的条件;地址已经存在,就立刻把排查重心移到就绪、端口监听和网络路径,避免在 selector 上反复兜圈。