跨对象同步执行后出现字段缺失、状态不一致或重复创建，排查时先别急着改配置。更稳妥的顺序是先界定异常范围，把问题拆成可核对的症状；再沿“触发条件—源数据前提—字段映射—目标侧规则—写入结果”逐段比对源对象快照、同步日志和目标对象当前值。定位到具体环节后再修复、回刷并抽样验证，能减少反复试错对业务数据的影响。
要点总览（TL;DR）
- 先把异常拆成四类症状：目标字段为空、字段值错误、状态位置不同、重复创建，并按全部/批量/单条、首次/更新同步划分范围，建立可复现样本。
- 沿同步链路按五个检查点顺序排查：触发条件是否命中、源数据是否满足前提、字段映射是否完整、目标侧规则是否改写结果、写入是否成功。
- 把常见原因写成可验证假设，用源对象快照、同步日志和目标对象变更记录三方比对，区分同步未执行与执行后被改写。
- 处置按原因分类：配置问题先在单条样本验证，数据问题定向回刷并明确幂等要求，重复创建先停触发再清理存量。
- 修复后用原样本和新增抽样双向核对，并把本次原因沉淀为映射检查项、必填校验清单和同步后一致性抽查。
先界定异常范围：哪些记录、哪些字段、什么状态
排查的第一步是把“字段缺失或状态不一致”从一句笼统描述拆成可核对的症状。不同症状指向的环节不同，混在一起看容易误判。建议先按四类登记：目标字段为空、目标字段有值但值不对、状态机位置与源对象不同、目标对象出现重复记录。前两类属于字段问题，第三类属于流程问题，第四类往往与写入失败后的重试或触发重复命中有关。
接着划分影响范围。按记录数量区分全部记录、某类记录和个别记录；按同步类型区分首次同步和更新同步；按触发方式区分新建触发和变更触发。全部记录异常通常指向触发条件或映射配置的整体问题，个别记录异常更可能与源数据为空、类型不符或唯一性约束冲突有关。范围判断直接决定后续排查是查配置还是查数据。
为每条异常建立可复现样本，至少记录源对象标识、目标对象标识、同步时间、操作人和异常表现。样本要能对应到同步日志中的具体执行记录，否则后续无法判断同步是否执行过。下表可作为登记模板使用。
| 症状分类 | 典型表现 | 优先怀疑方向 | 登记要点 |
|---|---|---|---|
| 字段缺失 | 目标字段为空，源字段有值 | 映射漏配、目标必填拦截 | 源字段值、目标字段值、同步时间 |
| 字段值错误 | 目标有值但与源不一致 | 映射到错误字段、值集转换错误 | 两侧字段值、字段类型 |
| 状态不一致 | 状态机位置不同 | 触发时机错位、状态值映射错误、目标侧流程覆盖 | 源状态、目标状态、变更时间线 |
| 重复创建 | 同一业务对象出现多条目标记录 | 唯一键缺失、重试重复写入、触发重复命中 | 重复记录标识、创建时间、触发记录 |
登记完成后，先挑一条影响面小、信息完整的样本作为排查主线。单条样本能复现问题，后续每段检查才有对照依据；如果单条无法复现，说明问题可能与批量条件或并发执行有关，范围判断需要重新调整。
沿同步链路分段定位：从触发到写入的五个检查点
跨对象同步是一条有先后顺序的链路，排查也应按顺序推进。跳过前面的检查点直接改映射，容易在错误的位置反复调整。五个检查点依次是触发条件、源数据前提、字段映射、目标对象自身规则和写入结果，每个检查点都用源对象快照、同步日志和目标对象当前值三方比对。
检查点一：触发条件是否命中
先确认这条记录是否满足同步规则的触发条件。观察过滤条件是否把该记录排除在外，事件类型是否与本次操作匹配，触发时机是创建时、更新时还是状态变更时。日志中没有该记录的执行痕迹，通常说明触发未命中，此时问题不在映射，而在条件配置或操作方式。
检查点二：源数据是否满足前提
触发命中后，检查源字段是否具备可同步的值。必填字段为空、字段类型或格式与目标不兼容、选项值不在目标对象的可选范围内，都会导致目标侧写入被拦截或写入空值。这一步要对照源对象快照逐字段确认，尤其注意日期格式、人员字段和多值字段。
检查点三：字段映射是否完整
映射问题有三种常见形态：目标字段没有配置映射、映射到了错误的同名字段、多值字段在写入时被截断。核对方式是拿源字段清单与映射配置逐项对照，再用一条样本验证写入结果。字段缺失且源字段有值时，映射漏配的可能性最高。
检查点四：目标对象自身规则是否改写结果
同步写入成功不等于最终结果正确。目标对象的必填校验、状态流转限制、自动化规则可能在写入后再次修改字段或状态。判断方法是查看目标对象的变更记录：如果写入后短时间内出现第二次变更，且操作来源是目标侧规则，就属于规则覆盖，需要调整目标侧规则或同步顺序。
检查点五：写入结果是否成功
最后确认写入本身是否完成。权限不足会导致写入失败，唯一性约束冲突会导致创建被拒绝或产生重复记录。日志中的失败记录、跳过记录和实际创建数量要一起看，失败后若存在重试，还要确认重试是否造成重复写入。
| 检查点 | 观察对象 | 判定依据 |
|---|---|---|
| 触发条件 | 规则过滤条件、事件类型、日志执行记录 | 日志无执行痕迹即触发未命中 |
| 源数据前提 | 源对象快照、字段类型与选项值 | 空值、格式不符、值集越界 |
| 字段映射 | 映射配置、源字段清单 | 漏配、错配、多值截断 |
| 目标侧规则 | 目标对象变更记录、目标侧自动化规则 | 写入后出现二次变更 |
| 写入结果 | 同步日志、目标记录数量 | 失败、跳过、重复创建 |
原因假设与排除证据：怎么判断是哪一类问题
链路分段给出的是位置，原因判断还需要把常见解释写成可验证的假设，再用证据确认或排除。假设不能直接当结论，每条假设都要有支持它的观察和能排除它的反证。下表按症状整理了三组常见假设及对应证据。
| 症状 | 原因假设 | 支持证据 | 排除证据 |
|---|---|---|---|
| 字段缺失 | 源字段为空 | 源对象快照中该字段无值 | 源字段有值且日志显示已读取 |
| 字段缺失 | 映射漏配 | 映射配置中无该目标字段 | 映射存在且其他记录同字段正常写入 |
| 字段缺失 | 目标必填拦截 | 日志有校验失败记录 | 日志显示写入成功且字段仍为空 |
| 状态不一致 | 触发时机错位 | 状态变更发生在同步执行之后 | 同步执行时间晚于状态变更 |
| 状态不一致 | 状态值映射错误 | 源状态与目标状态存在固定偏移 | 部分记录状态一致、部分不一致 |
| 状态不一致 | 目标侧流程覆盖 | 目标变更记录显示规则二次修改 | 目标变更记录只有同步一次写入 |
| 重复创建 | 唯一键缺失 | 重复记录的业务标识相同但无唯一约束 | 存在唯一约束且重复记录标识不同 |
| 重复创建 | 重试重复写入 | 日志中同一记录多次执行且均成功 | 日志只有一次执行记录 |
| 重复创建 | 触发条件重复命中 | 同一业务动作触发多条规则 | 规则清单中只有一条相关规则 |
其中最容易混淆的是“同步未执行”和“执行了但结果被改写”。前者在日志中找不到执行记录，问题在触发条件或规则启用状态；后者日志显示执行成功，但目标对象当前值与预期不同，需要对照目标对象的变更记录，看写入之后是否还有别的来源修改了数据。用日志时间线与目标变更记录按时间排序对照，两类情况通常能清楚分开。
状态不一致还要注意一种情况：源对象状态在同步执行后继续变化，而同步只在特定时点触发一次。这时目标状态停留在旧值属于触发时机设计的结果，不是写入失败。判断依据是源对象状态变更时间与同步执行时间的先后关系。
处置步骤：按定位结果修复并控制影响面
定位到具体环节后，处置要按原因分类进行，并且先控制影响面再修复。配置类问题优先在测试对象或单条样本上验证，确认无误后再放开范围；数据类问题涉及已产生的错误记录，需要明确回刷范围和幂等要求；重复创建要先止住新增，再清理存量。
配置类问题的处置
- 修正字段映射、值集对应关系或触发条件，一次只改一处，便于判断哪项修改生效。
- 在测试对象或单条样本记录上执行一次同步，核对目标字段和状态是否符合预期。
- 确认样本通过后，再对受影响范围放开规则，观察首批执行结果。
数据类问题的处置
对已缺失或值错误的记录做定向回刷，回刷前明确三件事：回刷哪些记录、以什么条件筛选、重复执行是否会产生副作用。回刷范围尽量按样本特征收窄，避免全量重跑把正确记录也覆盖。回刷后逐条核对原样本，确认字段和状态恢复。
重复创建的处置
先停用触发规则或暂停同步，阻止继续产生重复记录；再按业务标识归并重复记录，保留哪一条、合并哪些字段要提前确定；清理完成并核对数量后再恢复同步。恢复后观察一段时间的新增记录，确认不再重复。
涉及批量修改或删除时，操作前先导出受影响记录作为备份，并设定停止条件，例如失败数量超过阈值、抽样核对出现新的不一致时立即暂停。回退方式也要提前想好：配置修改保留原配置记录，数据清理保留备份文件，确保能在发现问题时恢复到操作前状态。
在规则驱动的同步场景中，ONES Project 自动化规则提供运行日志，可查看规则的执行状态，便于把每次执行与源对象快照、目标对象当前值对照；其预置模板覆盖需求与工单状态同步、需求与任务所属迭代同步、父子工作项状态联动等场景，排查状态不一致时可以据此确认同步方向与触发时机是否符合配置预期。具体日志字段和可用范围以实际产品版本为准。
验证恢复与复发预防
修复生效不能只看一条记录。验证要覆盖原样本和新增抽样两类：原样本确认此前缺失的字段已补齐、错误的值已纠正、状态已回到正确位置；新增抽样确认修复后的同步在正常业务操作下持续产出正确结果。两类都通过，才能判断问题已解决。
同步日志的指标也要一起看。失败率、跳过记录数和重复创建数应回到预期水平，若仍有零星失败，要逐条确认是数据前提不满足还是新的配置问题。验证结果建议登记成表，记录样本标识、核对字段、修复前后值、核对人和核对时间，便于后续追溯。
| 验证项 | 核对内容 | 通过标准 |
|---|---|---|
| 原样本回刷 | 字段值、状态位置 | 与源对象一致 |
| 新增抽样 | 新建与变更两类触发 | 目标结果符合映射预期 |
| 日志指标 | 失败、跳过、重复数量 | 归零或处于可解释范围 |
| 目标侧规则 | 是否存在二次覆盖 | 变更记录只有同步写入 |
复发预防要把本次原因转成可执行的检查项。映射变更后增加字段对照检查，源字段新增必填项时同步更新校验清单，关键状态字段配置同步后校验规则，定期抽查源与目标的一致性。每项检查明确责任人和复核时点，例如映射调整由配置人自查、每周由流程负责人抽查一批关键记录。这样同类问题在下一次配置变更时能被提前发现，而不是等业务反馈后再回头排查。
常见问题
同步日志里查不到某条记录的执行痕迹，还需要继续查字段映射吗？
不需要先查映射。日志中没有执行记录，通常说明触发条件未命中或规则未启用，问题出在链路更靠前的位置。此时应核对过滤条件是否把该记录排除、事件类型是否与本次操作匹配、触发时机是创建时还是状态变更时，以及规则本身是否处于启用状态。确认触发命中后，再往后检查源数据前提和字段映射。
目标字段有值但和源对象不一致，和字段缺失的排查路径有什么不同？
字段缺失优先怀疑映射漏配或目标必填拦截，字段值错误则要重点查映射是否指向了错误的同名字段、值集转换是否出错、多值字段是否被截断。两者都要先确认源字段本身的值，再对照映射配置，最后看目标对象变更记录中写入之后是否还有别的来源修改过该字段。
状态不一致时，怎么判断是同步写入失败还是目标侧流程又改了一次？
看目标对象的变更记录。如果只有同步这一次写入，且写入值与源状态映射结果不同，问题在状态值映射或触发时机；如果写入后短时间内出现第二次变更，且操作来源是目标侧自动化规则或状态流转限制，就属于规则覆盖。把同步日志时间线与目标变更记录按时间排序对照，两类情况通常能分开。
重复创建清理时，先停同步还是先删重复记录？
先停用触发规则或暂停同步，阻止继续产生新的重复记录，再按业务标识归并存量。清理前要确定保留哪一条、合并哪些字段，操作前导出受影响记录作为备份，并设定停止条件，例如失败数量超过阈值或抽样核对出现新的不一致时立即暂停。清理完成并核对数量后再恢复同步，恢复后观察一段时间的新增记录。
修复后只核对原来出问题的那几条记录，能确认问题解决了吗？
不够。原样本只能确认已产生的错误被纠正，还需要用修复后的正常业务操作新增一批抽样记录，覆盖新建触发和变更触发两类场景，确认同步持续产出正确结果。同时看同步日志中失败率、跳过记录数和重复创建数是否回到预期水平，零星失败要逐条确认是数据前提不满足还是新的配置问题。
