通过YAML部署Kubernetes时Pod与Service无法关联求助

1. 标签选择器不匹配 #

这是最常出现的问题。Service通过spec.selector字段匹配Pod的标签，两者必须完全一致（包括键名、值的拼写和大小写）。

示例错误场景：

• Deployment的Pod模板标签：

spec:
  template:
    metadata:
      labels:
        app: demo-api
        env: test

• Service的选择器：

spec:
  selector:
    app: demoApi  # 拼写错误，应为demo-api

检查方式：执行kubectl get pods --show-labels查看Pod的实际标签，再对比Service的spec.selector配置。

2. 端口配置不对应 #

Service的spec.ports.targetPort必须和Pod中容器暴露的spec.containers.ports.containerPort完全匹配，否则即使标签匹配，流量也无法正常转发，表现为“未关联”。

示例错误场景：

• Pod容器端口：

containers:
- name: demo-container
  ports:
  - containerPort: 3000

• Service配置：

spec:
  ports:
  - port: 80
    targetPort: 300  # 端口号错误，应为3000

检查方式：执行kubectl describe pod <pod-name>查看容器暴露的端口，再对比Service的targetPort设置。

3. 命名空间不一致 #

如果Deployment和Service不在同一个命名空间，Service无法跨命名空间匹配Pod（除非使用集群域或外部名称服务）。检查两者的metadata.namespace字段是否一致。

检查方式：执行kubectl get deployments -A和kubectl get services -A查看资源所属命名空间。

4. Pod状态异常 #

即使Pod显示Running，也可能存在容器未正常启动、健康检查失败的情况，此时Service不会将流量转发给该Pod。

检查方式：执行kubectl describe pod <pod-name>查看事件和容器状态，或kubectl logs <pod-name>查看容器日志。

5. 副本配置错误 #

若Deployment的spec.replicas设置为0，或Pod被调度到不可用节点，会导致没有可用Pod供Service关联。

检查方式：执行kubectl get deployments查看副本数，kubectl get nodes查看节点状态。

内容的提问来源于stack exchange，提问作者Abhishek Vyas