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