1. 拓扑分布约束基础：Pod拓扑分布约束的概念、作用与核心字段详解

1.1 什么是Pod拓扑分布约束

Pod拓扑分布约束（topologySpreadConstraints）是Kubernetes调度器用于控制Pod在集群拓扑域（如节点、可用区）之间分布均匀性的策略机制。它允许运维人员定义Pod在跨故障域（zone）或跨节点时的分布规则，从而避免单点过载或资源倾斜，提升应用的可用性与容灾能力。

1.2 作用场景

• 跨可用区高可用： 确保工作负载的Pod副本均匀分布在多个可用区，避免单区故障导致全部实例不可用。
• 节点资源均衡： 防止大量Pod堆积在同一节点或同一机架，降低热点风险。
• 有状态服务分布： 对StatefulSet或Operator管理的Pod，约束其分布在不同的拓扑域中，提升数据冗余。
• 混合工作负载隔离： 将不同优先级或敏感度的Pod分散到不同拓扑域，减少相互影响。

1.3 核心字段详解

一个完整的拓扑分布约束定义包含三个必填字段和一个可选字段，如下表所示：

1.4 字段行为与计算逻辑

调度器在评估拓扑分布约束时，按以下步骤计算：

1. 分组： 根据 topologyKey 将集群中的节点划分为多个拓扑域（例如 zone-a、zone-b、zone-c）。
2. 计数： 在每个拓扑域中，统计已调度且匹配 labelSelector 的Pod数量。
3. 计算倾斜： 找出所有拓扑域中Pod数量的最大值与最小值，计算差值。
4. 判定： 如果差值 ≤ maxSkew，则约束满足；否则根据 whenUnsatisfiable 决定是否调度。

1.5 whenUnsatisfiable 策略对比

1.6 拓扑分布约束工作流程

下图展示了调度器在处理拓扑分布约束时的核心流程：

1.7 完整YAML示例

以下是一个典型的拓扑分布约束配置，要求Pod在可用区之间均匀分布，最大倾斜度为1：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-app
spec:
  replicas: 6
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      topologySpreadConstraints:
        - maxSkew: 1
          topologyKey: topology.kubernetes.io/zone
          whenUnsatisfiable: DoNotSchedule
          labelSelector:
            matchLabels:
              app: web
      containers:
        - name: nginx
          image: nginx:1.25

1.8 常见误区与避坑

• 误区一： 认为 maxSkew: 0 表示完全均匀。实际上 maxSkew: 0 要求所有拓扑域Pod数量完全相等，这在Pod副本数不是拓扑域数量的整数倍时会导致调度失败。
• 误区二： 忽略 labelSelector 的作用域。如果不指定，默认匹配当前Pod所属控制器下的所有Pod，但跨控制器的Pod不会被计入。
• 误区三： 在 whenUnsatisfiable: DoNotSchedule 下，如果集群资源不足导致无法满足约束，Pod将永久Pending，需要人工介入。

1.9 拓扑分布约束与Pod反亲和对比