多可用区场景下Pod拓扑分布约束不生效问题排查

我的配置 #

YAML文件中配置的Pod拓扑分布约束如下：

topologySpreadConstraints:
        - maxSkew: 1
          topologyKey: "topology.kubernetes.io/zone"
          whenUnsatisfiable: DoNotSchedule
          labelSelector:
            matchLabels:
              app: license-v1

集群环境 #

集群共有6台节点实例，3台位于可用区1a，3台位于可用区1b。

问题现象 #

按预期，应用上述配置后两个Pod应被调度到不同可用区的节点，但实际调度结果显示两个Pod运行在同一个节点上：

NAME       READY  STATUS    RESTARTS  AGE     IP        NODE                          NOMINATED NODE   READINESS GATES
app-pod-1  1/1    Running   0         4m48s   *.*.*.*   ip-*.*-233-140.eu-central-1   <none>           <none>
app-pod-2  1/1    Running   0         4m51s   *.*.*.*   ip-*.*-233-140.eu-central-1   <none>           <none>

问题原因及解决办法 #

核心原因：标签不匹配 #

拓扑分布约束通过labelSelector.matchLabels: app: license-v1筛选需要参与分布计算的Pod，若实际运行的app-pod-1、app-pod-2未携带该标签，调度器会判定所有可用区中符合条件的Pod数量均为0。此时将两个Pod调度到同一可用区甚至同一节点，完全满足maxSkew:1的要求（各区域Pod数差值为0，小于等于1），约束无法起到分散调度的作用。

解决步骤 #

• 验证Pod标签：执行kubectl describe pod app-pod-1，检查Pod的Labels字段是否包含app: license-v1。若缺失，需修改Pod所属的Deployment/StatefulSet配置，在Pod模板中添加该标签。
• 确认节点标签：执行kubectl get nodes --show-labels，检查所有节点是否带有正确的topology.kubernetes.io/zone标签，且可用区1a、1b的标签值准确。
• 排除其他调度规则干扰：检查Pod是否配置了节点亲和性、节点选择器或污点容忍规则，这类规则可能强制Pod调度到特定节点，覆盖拓扑分布约束逻辑。
• 调整约束配置（可选）：若需针对当前Pod做分布约束，可将labelSelector改为匹配当前Pod的实际标签，或使用matchExpressions实现更灵活的标签匹配。

内容的提问来源于stack exchange，提问作者Ruchita Sheth