podaffinity和podantiaffinity字段名易错，affinity是顶层字段，下分podaffinity、podantiaffinity、nodeaffinity三类；反亲和性必须配topologykey，否则静默失效；labelselector需用matchlabels或matchexpressions；golang应用pod标签须与亲和规则严格一致；required为硬约束，preferred为软约束，调试建议先用preferred验证。
PodAffinity 和 PodAntiAffinity 的字段名别写错
很多人在 YAML 里把 podAffinity 写成 affinity.pod 或者漏掉 topologyKey，结果调度器直接忽略整个块。Kubernetes 不报错，但 Pod 就卡在 Pending 状态——因为亲和性规则没生效，不是被拒绝，而是被“视而不见”。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
affinity是顶层字段，下面分podAffinity、podAntiAffinity、nodeAffinity三类，不能混用或嵌套错层级 - 每个
requiredDuringSchedulingIgnoredDuringExecution或preferredDuringSchedulingIgnoredDuringExecution必须包含topologyKey，常见值如topology.kubernetes.io/zone或kubernetes.io/hostname - 标签选择器（
labelSelector）必须用标准的matchLabels或matchExpressions，不能直接写labels:
反亲和性（AntiAffinity）必须配 topologyKey，否则无效
这是最常踩的坑：只写了 labelSelector 却没设 topologyKey，YAML 能通过 kubectl apply，但调度器不会做任何反亲和判断。原因很简单——K8s 不知道“同一拓扑域”指什么，是同一个节点？同一个可用区？还是同一个机架？
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 跨节点分散部署，用
topologyKey: kubernetes.io/hostname - 跨可用区高可用，用
topologyKey: topology.kubernetes.io/zone（需集群节点打了对应 label） - 不要用
topologyKey: ""或留空，这会导致规则静默失效 - 如果节点没打
topology.kubernetes.io/zone标签，zone级反亲和会退化为不生效，得先用kubectl label node xxx topology.kubernetes.io/zone=us-west-2a补上
Golang 应用容器镜像标签与 Pod 标签要对齐
K8s 亲和性靠 label 匹配，不是靠镜像名或 Deployment 名。Golang 应用本身不感知亲和逻辑，但它的 Pod 模板里写的 labels 必须和 podAffinity / podAntiAffinity 中的 labelSelector 完全一致，包括 key 和 value 的大小写、连字符。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 避免用动态生成的 label 值（比如带时间戳或 commit hash），除非亲和规则也同步更新
- 推荐在 Helm chart 或 Kustomize 中统一定义
app.kubernetes.io/instance这类稳定 label，再在亲和规则中引用 - 检查实际运行的 Pod label：运行
kubectl get pod -o wide后用kubectl describe pod <name></name>看Labels:部分，确认和 YAML 里写的完全一致 - Go 应用启动时若主动改自身 Pod label（比如通过 client-go patch），不会触发重新调度，亲和性只在调度阶段起作用
required vs preferred 的行为差异直接影响可用性
requiredDuringSchedulingIgnoredDuringExecution 是硬约束：找不到满足条件的节点，Pod 就永远 Pending；而 preferredDuringSchedulingIgnoredDuringExecution 是软约束：尽量满足，不行就退回到默认调度策略。很多人误以为“preferred 就是可有可无”，其实它会影响调度器打分，尤其在资源紧张时容易被忽略。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 核心服务（如数据库主节点、API 网关）用
required+topologyKey: kubernetes.io/hostname强制跨节点 - 有状态应用（如 Redis Cluster 分片）慎用
required，节点数少于副本数时会死锁 -
weight字段只在preferred中有效，范围 1–100，但多个规则之间权重不叠加，只是单条规则的倾向强度 - 调试时先用
preferred验证 label 和 topologyKey 是否正确，再切到required
真正麻烦的是 topologyKey 对应的 label 在节点上缺失，或者 label 值不一致——这种问题不会报错，也不会写进 Events，只能靠人工核对节点 label 和 Pod label 的映射关系。
