ArgoCD应用同步后长期卡在OutOfSync状态，通常因运行时自动更新字段（如.status.replicas、.metadata.generation等）被误判为差异，需通过argocd app diff确认具体差异字段，再精准配置spec.ignoreDifferences忽略不可控字段，并清理kubectl注解以消除漂移。
ArgoCD应用同步后长期卡在OutOfSync状态，但Git仓库清单和集群实际资源明明没改，说明比对逻辑把不该比的字段当成了差异源——这通常不是配置写错了，而是比对策略没关对。
先确认是不是真差异
执行 argocd app diff <app-name>，看输出里具体哪些字段被标为红色。如果只出现 .status.replicas、.status.conditions、.metadata.generation 或 .metadata.managedFields 这类字段，基本可以断定是运行时自动更新的字段干扰了比对。
这一步不能跳过。直接改 ignoreDifferences 而不看 diff 输出，等于蒙眼调参。
精准忽略不可控字段
打开 Application YAML，定位到 spec.ignoreDifferences 字段，按需添加规则：
方法一：忽略 Deployment 的状态字段
在 ignoreDifferences 下加一条：
- group: apps<br> kind: Deployment<br> jsonPointers:<br> - /status
方法二：忽略所有资源的时间戳和 generation
- group: ""<br> kind: "*"<br> jsonPointers:<br> - /metadata/creationTimestamp<br> - /metadata/generation<br> - /metadata/resourceVersion
【注意】不要用 kind: "*" 无差别忽略全部 status 字段，否则会掩盖真正的健康异常，比如 Deployment 实际卡在 CrashLoopBackOff 却被静默忽略。
检查自动生成的注解是否污染比对
第一步：用 kubectl get deploy <name> -o yaml 查看是否有 kubectl.kubernetes.io/last-applied-configuration 注解。
第二步：如果该注解存在且内容与 Git 清单不一致，说明之前用 kubectl apply 直接推过配置，造成漂移。
第三步：删掉这个注解：kubectl patch deploy <name> -p '{"metadata":{"annotations":{"kubectl.kubernetes.io/last-applied-configuration":null}}}'
第四步：触发一次手动 refresh：argocd app refresh <app-name>
这一步操作起来很简单，直接 patch 删除注解就行。但漏掉它，后面所有 ignore 配置都白搭。
验证 ignore 是否生效
① 执行 argocd app sync <app-name> 强制同步一次；
② 等待 10 秒，立即运行 argocd app diff <app-name>；
③ 如果 diff 输出为空，且 UI 上状态变为 Synced，说明 ignore 规则已命中；
④ 如果仍有差异，回到第一步重新看 diff 输出，确认新增了哪些字段，再追加对应 ignore 规则。
