本文面向实施与运维人员，用于从同步或集成的可观察症状出发定位原因、执行低风险检查并验证恢复。请先保存任务 ID、时间范围和脱敏后的错误信息。本文按 6.7.1 系列固定源码基线整理。由于当前仓库没有独立的 6.7.1.1 Tag，正式发布前还需核对实际构建版本，并在目标租户完成运行验证。
适用范围#
适用于身份数据上游集成或下游同步的连接、映射、账号关联、执行和结果回读阶段。快速判断#
1.
记录连接器、任务 ID、时间范围和失败对象；先不要重复提交高风险操作。
2.
检查网络与鉴权，再检查对象范围、唯一键、属性映射和目标字段约束。
3.
对比任务状态、错误明细、待处理列表和目标系统结果，判断是整体失败还是部分成功。
原因与处理#
本文档汇总了通讯录同步（平台推送数据到下游系统）过程中的常见问题与排错方法，涵盖连接失败、同步异常、字段映射、数据冲突等典型场景。适用于所有目标系统（钉钉、企业微信、AD/LDAP、泛微 OA、汇联易等）的同步排错参考。准备工作#
常见问题#
验证恢复#
使用原失败对象重新执行最小范围测试；确认平台任务、关系视图、错误明细和目标系统数据同时恢复，再逐步扩大范围。仍未解决时#
提交连接器名称、任务 ID、发生时间、对象类型、脱敏后的错误码与响应摘要，以及已经执行的检查。不要提交 Token、密码、Cookie、证书私钥、完整手机号或邮箱。 