Jira迁移后发现字段错位或重复数据，通常先怀疑三类来源：字段映射规则与目标字段类型不匹配、迁移批次重复执行或断点续跑缺少幂等控制、源数据本身存在重复或空值。排查时按“症状分类—取样本—回溯映射与批次日志—比对源与目标记录”的顺序缩小范围，用少量样本复现问题，再决定修复方式。修复前保留源数据与迁移日志，避免二次写入放大重复。
要点总览（TL;DR）
- 字段错位多来自映射规则与目标字段类型不匹配、自定义字段ID与名称混用、枚举/用户/日期等特殊字段转换不完整；重复数据多来自批次重复执行、断点续跑缺少幂等键，或源系统本身已有重复记录。
- 排查按“症状分类—取样本—回溯映射与批次日志—源目标逐字段比对”推进，先用3到5条样本复现，再扩大到批次核对。
- 区分重复来源看两点：重复记录是否集中在同一批次窗口、同一源ID是否对应多条目标记录；前者指向执行侧，后者指向源数据侧。
- 确认原因前不对目标系统做批量删除、覆盖或重新迁移；清理前导出待处理清单并备份源数据与迁移日志。
- 修复后用抽样与全量核对结合验证，并把映射配置版本和批次幂等规则固化，迁移前做源数据清洗与试迁移。
先分清症状：字段错位和重复数据各指什么
排查的第一步是把“感觉数据不对”转成可观察、可核对的具体表现。字段错位和重复数据指向不同的原因域，混在一起看容易把两类问题都归到迁移工具上，反而拖慢定位。
字段错位的常见表现
- 值落到相邻字段：例如“优先级”的值出现在“严重程度”字段里，或描述内容被写进备注字段。
- 枚举值变成空：源系统有值，目标系统对应字段为空，或显示为默认选项。
- 格式异常：日期字段出现时区偏移、格式不识别，用户字段显示为账号ID而非姓名，多选字段只剩一个选项。
- 字段整体缺失：迁移后某自定义字段在目标工作项上不可见，值也无处存放。
重复数据的常见表现
- 同一问题出现两条记录：标题、编号或关键属性相同，创建时间接近。
- 评论或附件重复挂载：同一条评论出现两次，同一附件挂载多份。
- 子任务重复生成：父任务下出现成对的同名子任务。
- 关联关系重复：问题链接、版本关联等出现重复条目。
如何界定影响范围
先导出目标系统的问题列表，至少包含问题编号、标题、创建时间、关键字段值和迁移批次标识；再按项目、问题类型、创建时间窗口分组统计记录数。把统计结果与源系统同口径的记录数对比，差异集中在某个项目、某类问题或某个时间窗口，就说明影响范围有限，可以优先取该范围的样本。范围清单应写明：受影响的项目与问题类型、异常记录数量、涉及的字段或关联对象、首次发现时间，以及是否仍在持续产生新异常。
字段错位的常见原因与排除证据
字段错位的原因假设可以归为映射配置、字段标识和特殊类型转换三类。逐项验证时，用单条样本记录做源目标逐字段比对，比直接看全量报表更容易定位到具体规则。
| 原因假设 | 典型表现 | 验证证据 |
|---|---|---|
| 字段映射表与目标字段类型不一致 | 文本值写入单选字段后为空，或数值字段出现截断 | 调出映射配置，核对源字段类型与目标字段类型；用一条样本复现写入结果 |
| 自定义字段ID与名称混用 | 同名不同ID的字段互相串值，或迁移后值落到另一个同名字段 | 导出源与目标字段的ID、名称、类型清单，逐一对照映射表引用的是ID还是名称 |
| 枚举与多选转换规则不完整 | 选项值丢失、映射到默认项、多选只剩一项 | 检查选项值映射表是否覆盖全部源选项，包括历史停用选项 |
| 用户与日期字段转换异常 | 用户显示为ID、日期偏移或格式不识别 | 取含用户和日期的样本，核对账号映射关系与时区设置 |
验证时建议固定一条样本记录，把源记录的每个字段值、目标记录的对应值、映射规则三者并列，逐字段打勾或标记差异。差异集中在某一类字段，就回到该类字段的转换规则；差异分散且无规律，优先怀疑映射表引用了错误的字段标识。映射配置属于迁移范围的一部分，具体规则以实际迁移方案为准，排查时应以当时执行的配置版本为准，避免用修改后的配置解释旧结果。
重复数据的常见原因与排除证据
重复数据要先判断来源：是迁移执行阶段重复写入，还是源系统本来就有重复记录被原样带入。两者的修复方式不同，判断错了会在目标系统里反复清理却继续产生新重复。
迁移执行侧的原因
- 批次重复执行：同一批数据被调度两次，或失败后整批重跑而未跳过已成功记录。
- 断点续跑缺少幂等键：续跑时以标题或创建时间判断是否已迁移，遇到同名或同时间记录就重复写入。
- 关联对象重复挂载：问题主体已存在，评论、附件、子任务在补充迁移时再次挂载。
源数据侧的原因
- 源系统中已存在重复问题，迁移按原样保留。
- 源数据存在空值或占位值，迁移后多条记录落到同一默认值，看起来像重复。
- 历史导入遗留的重复记录在源系统未被清理。
用证据区分来源
调取迁移批次日志，确认同一批次的执行次数、开始与结束时间、成功与失败记录数。若重复记录的创建时间集中在同一批次窗口内，且日志显示该批次执行过两次或存在续跑记录，倾向执行侧原因。若重复记录在源系统中已能查到成对存在，或重复对的创建时间跨度很大、分属不同批次，倾向源数据原因。唯一标识比对是关键：用源系统的问题ID或编号与目标系统的迁移来源标识对照，同一源ID对应多条目标记录，说明写入环节重复；不同源ID对应相似内容，说明源数据本身重复。
按顺序排查：从样本复现到全量核对
排查顺序的目标是用最小成本确认原因，再决定是否扩大到全量。建议按以下步骤推进，每一步留下记录，便于后续修复和复盘。
- 小样本复现。从影响范围清单中取3到5条异常记录，覆盖不同字段类型或不同重复形态，确认异常可以稳定复现，并记录复现条件。
- 读取映射配置与批次日志。先看配置版本和字段映射表，再看对应批次的执行记录，确认异常记录属于哪个批次、该批次执行了几次。
- 源目标逐字段比对。以源问题ID为锚点，比对目标记录的字段值、关联对象和创建时间，标记差异类型。
- 扩大到批次核对。样本确认原因后，按批次或项目统计异常记录数，判断是否需要全量核对。
- 设定停止点。在确认原因之前，不对目标系统执行批量删除、覆盖或重新迁移。需要清理重复记录时，先导出待处理记录清单并备份源数据与迁移日志，保留回滚依据。
排查过程中，字段配置和迁移记录的管理方式会影响效率。以ONES为例，其Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，字段配置属于迁移范围；迁移问题数据包括属性和属性值、附件、评论等信息。排查时可以在目标系统中对照工作项的字段配置与迁移后的记录，核对字段值落位和关联对象是否与源记录一致，把差异记录整理成清单再进入修复。具体映射规则和日志能力以实际迁移方案为准。
修复后的验证与复发预防
修复完成后，验证要回答两个问题：异常记录是否恢复正确，以及是否还有未发现的同类问题。抽样核对用于快速确认修复动作生效，全量核对用于确认影响范围内没有遗漏。
验证清单
- 抽样验证：从已修复记录中抽取样本，逐字段比对源与目标，确认字段值、枚举选项、用户和日期显示正确。
- 全量核对：按项目或批次统计记录数，与源系统同口径对比，确认重复记录已清理且无新增。
- 关键字段一致性：对必填字段、状态字段和关联对象做一致性检查，确认没有因修复产生新的空值或错位。
- 关联对象检查：抽查评论、附件和子任务的挂载数量，确认没有重复挂载或丢失。
预防措施
把本次排查确认的映射规则固化到迁移配置中，字段引用统一使用ID并保留映射表版本；批次执行增加幂等键，续跑时按源记录唯一标识跳过已成功记录。迁移前做源数据清洗，处理重复记录和空值，并通过试迁移验证字段映射和批次逻辑。ONES方案也建议在正式迁移前确认数据范围、功能匹配和系统适配，并对定制场景逐项评估，这些动作同样有助于减少迁移后的字段与重复问题。修复和验证的记录应归档，作为后续迁移或增量同步的参照。
常见问题
迁移已经跑完，源系统还保留着，排查时应该先动哪一边？
先动只读的一边。优先从源系统导出问题清单和字段值，从目标系统导出同口径记录，在离线表格里比对，避免在任一系统中直接修改数据。源系统在迁移后通常还会产生新数据，比对时要锁定迁移截止时间点，取该时间点之前的记录作为样本，否则新增记录会干扰判断。确认原因并制定修复方案后，再决定是否在目标系统执行清理。
同一批数据重跑后出现重复，能否直接删掉后写入的那一批？
不建议直接按时间先后删除。先确认后写入的记录是否带有额外的关联对象，例如评论、附件或子任务，这些对象可能挂载在较新的记录上，直接删除会造成关联丢失。更稳妥的做法是导出重复记录清单，标注每组重复中保留哪条、合并哪些关联对象，备份后再执行清理。若重复仍在持续产生，应先停掉对应批次的调度，处理完幂等逻辑再恢复。
字段错位只出现在少数记录上，是否还需要全量核对？
需要看错位是否与特定条件相关。如果少数记录集中在某个问题类型、某个自定义字段或某个迁移批次，说明映射规则在该条件下失效，同条件下的其他记录也可能受影响，应按该条件做范围核对。如果样本差异分散且找不到共同条件，优先怀疑映射表引用了错误的字段标识，此时全量核对更稳妥。核对以记录数和关键字段一致性为主，不必逐条人工比对全部字段。
迁移后发现字段值正确但显示为空，属于字段错位吗？
这类情况要分两层看。先确认目标字段中是否存有值，可通过导出或字段配置查看；若值存在但界面不显示，问题可能出在字段配置、权限或视图设置，与迁移映射无关。若目标字段本身为空，则回到映射规则检查源字段类型与目标字段类型是否兼容，以及该字段是否在迁移范围内。区分这两层可以避免把配置问题误判为迁移错误。
如何避免下一次增量迁移再次出现同类问题？
把本次确认的映射规则固化为配置版本，字段引用统一使用ID，并保留每次迁移使用的映射表快照。批次执行增加幂等键，续跑时按源记录唯一标识跳过已成功记录。增量迁移前先做小批量试跑，核对字段落位和记录数，再放开全量。迁移前的源数据清洗同样重要，重复记录和空值在源侧处理，比在目标侧清理成本更低。
