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；
