5.4 避坑指南：GitOps 生产环境常见故障排查与性能调优

1. 引言：当 GitOps 落地到生产

GitOps 不是银弹。落地后你很快会遇到渲染差异、漂移风暴、同步性能、权限边界、密钥管理等一系列工程问题。本章按“现象 -> 诊断 -> 修复 -> 预防”的路径提供一线作战清单。

2. 常见故障与修复

2.1 OutOfSync 一直抖动

• 现象：同步后马上 OutOfSync，UI 不断在 Sync/OutOfSync 之间切换。
• 诊断：
  • 是否有控制器在修改 PodSpec（比如 Istio/Linkerd 注入器）？
  • 是否未忽略status、last-applied-configuration等易变字段？
• 修复：
  • 配置 Resource 自定义差异忽略（ignoreDifferences）。
  • 为 MutatingWebhook 修改增加同步波次控制，避免相互竞态。

2.2 同步超时/性能差

• 现象：应用资源多（>3k），同步需要 10+ 分钟；UI diff 卡顿。
• 诊断：
  • 单一 Application 是否过大？是否在同一个 Path 下塞入过多服务？
• 修复：
  • 拆分 Application（按域/微服务/资源种类），降低 Diff/Sync 开销；
  • 使用 Server-Side Apply/Diff；