Jira迁移工具执行完成后发现数据缺失、字段错位或重复记录，先不要急着重跑。把异常按“数量对不上、字段值放错、关联数据丢失”三类分开，锁定迁移批次和时间窗口，用源端与目标端的计数对账定位范围，再抽取样本比对字段映射，最后追溯重复记录的来源。每一步都以计数、样本ID、映射配置和执行日志为依据，确认原因后再决定补录、修正映射重跑或合并记录。
要点总览（TL;DR）
- 先按症状把异常归入三类：记录数量对不上（缺失或重复）、字段值错位、附件与评论等关联数据丢失，三类可能同时出现，需分别记录影响范围。
- 排查顺序为：锁定迁移批次与执行日志，用源端导出计数与目标端计数逐项目、逐问题类型对账，再抽取样本比对字段映射表，最后追溯重复记录来源。
- 处置动作以证据为前提：缺失按受影响ID清单补录或重跑，错位修正映射后定向重导，重复按唯一标识合并或删除，破坏性操作前须备份并设定停止点。
- 处置后用同一口径复验计数、字段抽样和关联数据，并在小批量试迁移上验证通过后再扩大范围，将映射表与唯一标识规则固化为迁移前检查清单。
三类异常各自表现成什么样
迁移后的异常往往不是单一类型。一个项目可能同时出现部分问题未导入、自定义字段值落到别的字段、重跑后同一问题出现两条。先把症状归类，才能避免用一种原因解释所有现象。下面按三类分别列出常见表现，并给出界定影响范围的方法。
数据缺失的常见表现
- 目标端问题总数少于源端导出计数，差额集中在某几个项目或某类问题类型。
- 问题主体已导入，但附件、评论、变更历史等关联数据缺失，打开问题只能看到标题和描述。
- 整个项目未出现在目标端，或项目存在但问题列表为空，通常与迁移范围配置或权限有关。
- 部分状态的问题缺失，例如已关闭问题未导入，需要核对迁移时是否设置了状态过滤条件。
字段错位的常见表现
- 自定义字段的值出现在另一个字段中，例如“客户名称”的内容落到“备注”字段。
- 下拉选项、多选字段的值变为空值或落到默认选项，原选项在目标端不存在同名项。
- 日期字段出现时区偏移，用户字段显示为姓名文本而非可识别的用户对象。
- 必填字段在迁移后被自动填入默认值，掩盖了源端原本为空的事实。
重复记录的常见表现
- 同一问题在目标端出现两条或多条，问题编号不同但标题、描述一致。
- 子任务与父任务被分别创建，父子关系丢失后又以独立问题形式重复出现。
- 迁移中断后重跑，前一批已写入的记录未去重，数量接近翻倍。
- 同一问题在不同项目下各有一份，通常与源端问题曾跨项目移动有关。
三类问题共存的判断方式
当数量对不上时，先判断是缺失还是重复，两者可能同时存在：一部分项目少导，另一部分项目因重跑翻倍，总量相抵后看起来正常。建议按项目、问题类型、创建时间三个维度分别计数，任何一层出现差异都单独记录。影响范围以“受影响的记录ID清单”为准，而不是只看总数差额。清单是后续补录、修正和合并的操作对象，也是验证恢复是否完成的依据。
| 异常类型 | 典型表现 | 首要证据 | 初步处置方向 |
|---|---|---|---|
| 数据缺失 | 问题数少于源端、附件评论丢失、整项目未导入 | 源端导出计数与目标端计数、迁移范围配置 | 按批次补录或重跑受影响范围 |
| 字段错位 | 字段值串位、选项变空或默认值、日期用户格式异常 | 字段映射表、样本问题逐字段比对 | 修正映射后定向重导 |
| 重复记录 | 同一问题多条、父子任务重复、重跑后翻倍 | 重复记录ID清单、执行日志中的批次记录 | 按唯一标识合并或删除冗余 |
按证据逐层定位原因
排查的核心原则是先取证再下结论。迁移异常的原因经常被误判：看到数量少就认定工具丢数据，实际可能是迁移范围过滤掉了某类问题；看到重复就认定重跑出错，实际是源端本身存在重复问题。下面四步按从整体到局部的顺序推进，每一步都说明假设、需要什么证据、以及如何排除。
第一步：锁定迁移批次、时间窗口与执行日志
假设：异常与某次迁移执行的范围或中断有关。需要收集的证据包括本次迁移的批次标识、开始与结束时间、迁移范围配置（哪些项目、哪些问题类型、是否包含附件和评论）、执行日志中的失败条目和中断记录。如果日志显示执行中途失败后继续运行，那么缺失和重复都可能由续跑引起，应优先按批次拆分核对，而不是整体重跑。排除方法：若日志显示执行完整且范围配置与预期一致，则把注意力转向映射和源端数据本身。
第二步：逐项目、逐问题类型计数对账
假设：缺失集中在某一层，例如某个项目、某类问题类型或某个时间区间。做法是以源端导出计数为基准，在目标端按相同维度统计，形成对照表。差异出现的位置就是排查入口：整项目为零，查范围配置和权限；某问题类型缺失，查该类型的字段配置是否导致导入失败；某时间段缺失，查源端该时间段是否有批量操作或归档。计数对账同时能发现重复：目标端计数大于源端时，差额就是重复记录的规模。这一步的结论应写成“差异层+差异数量+受影响ID范围”，作为后续处置的输入。
第三步：抽取样本比对字段映射表
假设：字段错位源于映射配置与实际字段类型不匹配。抽取覆盖各类自定义字段的样本问题，逐字段比对源端值与目标端值，同时核对映射表中的字段类型、选项值集合、必填与默认值规则。重点检查三类情况：源端字段类型在目标端没有等价类型时的降级处理；选项值按名称匹配时出现的同名不同义或大小写差异；必填约束导致空值被默认值填充。样本比对能快速暴露系统性错位，若样本正常而个别记录异常，则转向检查这些记录在源端是否有特殊格式或插件生成的内容。
第四步：重复记录溯源
假设：重复来自三种成因之一。第一种是重跑未去重，特征是重复记录的创建时间集中在某次重跑窗口内，且内容完全一致；第二种是唯一标识缺失，迁移时未保留源端问题键作为匹配依据，导致同一问题每次导入都新建；第三种是关联对象被拆成多条，例如子任务与父任务分别导入且关系未建立，或问题跨项目移动的历史被展开为多条记录。区分方法是对重复组提取创建时间、源端问题键、父子关系字段，三者组合基本可以判定成因。不同成因对应不同处置，不能在未区分前统一删除。
确认原因后的处置动作
处置动作只在原因有证据支撑后执行。缺失、错位、重复的处理方式不同，共同前提是先备份、再确认影响范围、设定停止点。以下方案按异常类型分别说明，涉及删除或覆盖的操作都需要额外谨慎。
数据缺失的补录与重跑
先确认源端数据完整：源端导出计数是否覆盖了预期范围，是否存在导出时已被过滤的记录。确认后按受影响批次补录，补录范围以第二步形成的ID清单为准，避免全量重跑引入新的重复。如果缺失由迁移中断引起，重跑前应确认工具是否支持断点续跑或按范围重跑；若只能全量重跑，必须先处理已导入记录的匹配规则，否则会叠加重复。补录完成后立即做一次计数复核，确认差额归零。
字段错位的映射修正与定向重导
修正映射配置后，对受影响记录做定向重导，而不是整体重迁。重导前保留原记录或导出快照，便于逐字段比对修正结果。对于选项值缺失的情况，需要先在目标端补齐选项再重导，否则值仍会落到空值。对于日期和用户字段的格式问题，确认目标端的时区设置和用户匹配规则后再执行。定向重导的范围同样以样本比对中确认的受影响字段和记录为准。
重复记录的合并与删除
按唯一标识（通常是源端问题键）对重复组排序，保留关联数据最完整的一条，合并评论、附件和关联关系后删除冗余记录。操作前完成全量备份，记录删除清单，包含每条被删记录的ID、保留记录ID和合并内容。对于父子任务被拆分的重复，优先恢复父子关系再判断是否需要删除，避免误删有独立评论的子任务。合并和删除属于破坏性操作，应分批执行，每批完成后抽查，确认无误再进入下一批。
破坏性操作的前置条件
- 备份：目标端数据全量导出或快照，确认可恢复。
- 影响范围确认：待操作记录ID清单经过复核，与对账结果一致。
- 可回滚方案：明确回滚触发条件和回滚步骤，指定执行人。
- 停止点：设定每批操作后的检查项，出现新的计数差异或字段异常立即停止。
验证恢复与防止再次发生
处置完成不等于问题解决，需要用与排查阶段相同的口径复验，并把这次的经验固化为下次迁移的检查项。验证不通过时回到对应步骤重新取证，而不是继续叠加处置动作。
验证恢复的三项检查
- 计数复核：按项目、问题类型、时间窗口重新对账，目标端计数与源端一致，重复记录清零。
- 字段抽样比对：重新抽取样本问题，逐字段核对修正后的值，重点检查此前出错的字段类型和选项值。
- 关联数据检查：抽查附件、评论、父子关系和变更历史是否完整，确认合并操作未丢失内容。
三项检查都通过后，才算恢复完成。检查结果连同ID清单、映射配置版本和执行日志一起归档，作为本次迁移的记录。
用小批量试迁移验证规则
在扩大迁移范围前，先选取包含各类问题类型、自定义字段和关联数据的代表性项目做小批量试迁移。试迁移通过的标准与正式迁移一致：计数一致、字段抽样正确、无重复记录。试迁移能提前暴露映射配置和唯一标识规则的问题，把修复成本控制在少量数据上。试迁移不通过时修正配置再试，不带着已知问题扩大范围。
固化映射表与唯一标识规则
把本次迁移中验证过的字段映射表、选项值对照表和唯一标识规则整理成迁移前检查清单。清单至少包含：每个自定义字段的源端类型与目标端类型、选项值的对应关系、必填与默认值处理方式、问题唯一键的匹配字段、附件和评论的迁移范围。下次迁移或增量同步时按清单逐项核对，可以减少字段错位和重复的概率。
在ONES中承接迁移后的核对与记录
如果迁移目标是ONES，其Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，也包含问题类型、工作流、字段配置、权限配置等系统配置，以及属性和属性值、附件、评论等信息。迁移完成后，可以把对账中发现的异常记录整理为ONES中的工作项，按项目或批次建立核对任务，把计数差异、字段错位样本和重复记录清单作为任务描述或附件留存，指定负责人逐条关闭。字段映射表和检查清单可以放在ONES的文档中随项目维护，让迁移核对、处置和验证的过程有统一的记录位置，也方便后续增量迁移时复用同一套规则。对于依赖Jira插件的定制场景，迁移前仍需逐项评估，避免假设所有插件都能一一对应。
常见问题
迁移工具执行日志显示成功，但目标端问题数量仍然少于源端，可能是什么原因？
执行日志显示成功通常只说明迁移任务本身跑完，不代表所有记录都符合导入条件。常见原因包括：迁移范围配置过滤掉了部分项目或问题类型；源端某些问题因字段配置不满足目标端必填约束而被跳过；附件或评论因大小、格式限制未导入。建议先核对迁移范围配置与源端导出计数是否一致，再按项目、问题类型逐层对账，定位差异集中在哪一层，而不是直接重跑。
字段错位修正映射后，能否只重导受影响的记录而不影响已正确导入的数据？
可以按受影响记录做定向重导，前提是迁移工具支持按范围或按ID重跑，并且已导入记录有稳定的唯一标识用于匹配。操作前应保留原记录或导出快照，便于比对修正结果。如果工具只支持全量重跑，则需要先处理已导入记录的匹配规则，否则可能叠加重复。具体重跑机制需以所用工具的官方文档为准。
重复记录中有一条关联了评论和附件，另一条没有，合并时应该保留哪一条？
优先保留关联数据更完整的那条，通常是包含评论、附件和变更历史的一条。合并前先确认两条记录是否确实对应源端同一问题，可用源端问题键、创建时间和标题组合判断。合并时把缺失的评论和附件补充到保留记录，再删除冗余记录，并记录删除清单以便追溯。如果两条记录分别关联了不同的子任务或关联问题，需要先恢复关联关系再判断，避免误删有独立内容的记录。
小批量试迁移通过后，正式迁移仍然出现字段错位，可能漏掉了什么？
试迁移样本可能未覆盖所有字段类型和选项值组合。常见遗漏包括：只在部分项目中使用的自定义字段、选项值大小写或同名不同义的字段、依赖插件生成的字段内容、以及必填与默认值规则在不同问题类型下的差异。建议在试迁移样本中刻意纳入各类自定义字段和边界情况，并把验证过的映射表固化为检查清单，正式迁移前逐项核对。
迁移后核对发现少量记录缺失，但源端对应问题已被删除或归档，还需要补录吗？
先确认源端该问题在迁移时间窗口内的状态。如果源端已删除或归档且业务上不再需要，可以不补录，但应在对账记录中注明原因，避免后续误判为迁移遗漏。如果源端仍可恢复且业务需要保留，则按补录流程处理。关键是把“源端不存在”与“迁移丢失”区分开，两者对应的处置动作不同。
