迁移完成后发现字段丢失，先不要急着补数据。更稳妥的顺序是先确认丢了什么、影响哪些记录，再判断丢失发生在源端、映射、转换还是导入环节，用抽样和日志把猜测变成证据，最后按可重跑或不可重跑分别补回，并用字段级对账确认恢复。本文聚焦迁移数据内容层面的字段丢失，工作流状态、插件行为迁移和整体切换回退不在讨论范围内。
要点总览（TL;DR）
- 先确认丢了什么：整列缺失、部分记录为空、值被截断或变成默认值、枚举值落入未分类，四类症状对应不同原因，先形成字段、记录数、样例ID的症状清单。
- 按源端、映射、转换、导入四层逐一提出假设，用源导出抽样、映射表核对、迁移日志和失败记录清单验证，未证实前不当作结论。
- 处置前冻结写入或暂停增量同步并备份数据与映射配置；可重跑场景修正规则后小批量试跑再扩大范围，不可重跑场景按记录ID从源系统导出缺失字段做定向补录。
- 恢复以字段级对账加全量校验确认：比对非空率、枚举分布、抽样逐条值、记录总数与关联关系，由业务负责人依据对账表和处置日志验收。
- 把字段映射表版本、迁移前字段盘点和校验项写进迁移检查清单，作为下次迁移的固定动作。
先确认丢了什么：症状分类与影响范围
“字段丢失”是一个笼统描述，不同症状对应的原因和处置方式差别很大。第一步要把模糊的问题拆成可观察、可计数的事实，形成一份症状清单，作为后续排查和验收的共同基线。
常见症状可以归为四类：
- 整列缺失：目标系统中某个字段完全没有出现，所有记录都不带这个字段。通常指向映射表未覆盖或字段配置未迁移。
- 部分记录为空：字段存在，但一部分记录的值是空的。常见于源数据本身缺失、导入时被跳过或转换失败被置空。
- 值被截断或变成默认值：文本被截短，日期变成统一默认日期，人员字段变成空或管理员账号。多与格式转换和长度限制有关。
- 枚举值变成未分类：选项字段的值落入“未分类”或其他兜底选项，说明选项值没有建立对应关系。
界定影响范围时，至少记录四项信息：涉及哪些工作项类型、哪些字段、大约多少条记录、发现时点与可能的时间窗口。抽样时保留具体记录ID和源端、目标端的对照值，后续验证可以直接复用。症状清单建议包含字段名、症状类型、受影响记录数、样例ID、发现时点五列，由发现人填写、迁移负责人确认。
需要区分的是，流程状态错乱、附件缺失、插件配置未迁移属于另外的问题类型，排查路径不同，不要混在同一张清单里处理，否则会稀释证据、拉长定位时间。
按层排查：字段丢失的常见原因与排除证据
字段从源系统到目标系统要经过源端导出、字段映射、格式转换、批量导入四个环节，任何一层出问题都会表现为“字段丢了”。排查时逐层提出假设，并为每条假设找到可核查的证据，未证实之前只作为假设记录，不当作结论写进处置方案。
| 层级 | 原因假设 | 验证方法 | 可采信的证据 |
|---|---|---|---|
| 源端层 | 导出时带了筛选条件、权限范围受限，源数据本身缺字段或缺记录 | 用相同条件在源系统重新导出并抽样比对 | 源导出文件中该字段的非空率、记录总数与目标端差异 |
| 映射层 | 字段未建立映射、同名不同义、自定义字段未纳入映射表 | 逐项核对映射表与源字段清单 | 映射表中缺失的字段条目、映射到错误目标字段的记录 |
| 转换层 | 日期、人员、枚举、多值字段格式不兼容，转换失败后被置空 | 抽取转换失败的样例，查看原始值与目标值 | 转换报错记录、被置空的样例清单 |
| 导入层 | 批量上限、必填校验、重复记录合并、失败记录被跳过 | 核对导入批次日志与失败记录清单 | 失败记录ID列表、被合并记录的前后对照 |
排查顺序建议从导入层往源端层倒推：导入层的失败记录最容易拿到，能快速缩小范围；如果导入日志显示全部成功，再往转换层和映射层查；最后回到源端确认数据本身是否完整。每层排查后写一句结论，例如“映射表中缺少‘客户等级’字段，已证实”，或“转换层暂无异常证据，待验证”。
同名不同义是映射层最容易漏掉的情况：源系统和目标系统都有“优先级”字段，但选项定义不同，直接按名称映射会导致值全部错位或落入兜底选项。核对映射表时，除了看字段是否建立对应，还要比对选项值、数据类型和是否允许多值。
如果迁移由厂商工具或服务执行，可以向执行方索取迁移日志、失败记录清单和字段映射表，这三类产物是定位层级的主要依据。资料中没有说明具体工具会输出哪些报告时，以实际拿到的产物为准，不预设某种报告一定存在。
处置步骤：按可重跑与不可重跑分别处理
确认原因后，处置的第一动作是控制变量：暂停增量同步或冻结相关字段的写入，避免一边修复一边产生新的不一致。冻结范围以影响清单为准，冻结期间新产生的变更单独记录，修复完成后统一补入。
操作前先备份目标项目数据和当前映射配置，明确回滚方式：保留修复前的数据快照，记录本次处置的动作、范围、执行人和结果。设定停止条件，例如试跑批次的字段非空率低于预期、出现新的报错类型，就停止扩大范围并回到排查阶段。
可重跑场景：修正规则后按范围补导
- 修正映射表或转换规则，把缺失字段、错误对应关系和格式兼容问题一并处理。
- 选取一小批记录试跑，批次覆盖受影响的字段和记录类型，规模控制在便于逐条核对的量级。
- 试跑结果与源数据逐条比对，确认字段值、选项分布和关联关系正确。
- 分批扩大重跑范围，每批完成后记录结果，出现异常立即停止。
不可重跑场景：按ID定向补录
当原始迁移过程无法重放，或重跑会覆盖已人工修正的数据时，改用定向补录：从源系统按记录ID导出缺失字段的值，整理成导入模板，只更新目标字段，避免整条记录覆盖。补录前先在少量记录上验证模板格式和字段对应关系，确认无误后再批量执行。补录过程中保留源导出文件与导入结果，作为后续对账依据。
在ONES的迁移场景中，Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，字段配置与字段值分别迁移，因此核对时需要把“字段配置是否迁过来”和“字段值是否正确写入”分开检查。ONES把数据完整作为迁移目标之一，并建议在正式迁移前确认数据范围与功能匹配；这些属于方案层面的安排，具体到某次字段丢失的补导方式，仍以实际迁移工具和服务约定为准。
验证恢复与防止再次丢失
补回数据不等于恢复完成，需要用字段级对账和全量校验两层证据确认，并明确由谁依据什么判定通过。
字段级对账关注单个字段的质量：统计目标端每个受影响字段的非空率，与源端同字段对比；枚举字段比对选项分布，确认没有异常集中的“未分类”；按记录ID抽样逐条比对源值与目标值，抽样覆盖不同工作项类型和时间段。全量校验关注整体完整性：记录总数与源端一致，关键字段无空值，工作项之间的关联关系（如父子、关联链接）完整。
| 校验项 | 比对口径 | 通过标准 | 责任人 |
|---|---|---|---|
| 字段非空率 | 源端与目标端同字段对比 | 差异在约定阈值内，且无系统性缺失 | 迁移执行人 |
| 枚举分布 | 各选项记录数占比 | 无异常集中的兜底选项 | 迁移执行人 |
| 抽样逐条比对 | 按记录ID对照源值与目标值 | 抽样记录全部一致 | 业务负责人抽查 |
| 记录总数与关联关系 | 总量、父子与关联链接 | 与源端一致 | 迁移负责人 |
验收由业务负责人确认，依据是对账表、抽样比对记录和处置日志，而不是“看起来没问题”。验收通过后再解除写入冻结，把冻结期间记录的变更补入并再次抽查。
复发预防落在三件事上：维护字段映射表的版本，每次迁移前做字段盘点，把源字段清单、目标字段、选项对应关系逐项登记；把本次出现的症状和校验项写进迁移检查清单，下次迁移前逐条核对；迁移完成后先做小批量试跑和对账，再进入全量迁移。ONES的迁移方案建议在正式迁移前确认数据范围、功能匹配和系统适配，并把迁移工具、原厂服务和分阶段切换结合使用，这与上述检查清单的思路一致，可作为迁移前准备的参照。
常见问题
迁移后字段丢失，第一步该做什么？
先不要补数据，而是把“字段丢失”拆成具体症状并界定范围。记录涉及哪些工作项类型、哪些字段、大约多少条记录、发现时点，抽样时保留记录ID和源端、目标端的对照值。这份症状清单既是排查起点，也是后面验收恢复的基线。范围不清就动手补录，容易出现补了又漏、反复返工。
怎么判断字段丢失是源数据本身缺失，还是迁移过程造成的？
用相同筛选条件和权限范围在源系统重新导出一次，抽样比对源导出文件与目标端的记录总数和字段非空率。如果源导出里该字段本身就大量为空，问题在源端；如果源端完整而目标端缺失，再往映射、转换、导入层查。导入层的失败记录清单最容易拿到，可以先看它是否显示有记录被跳过或合并。
原始迁移无法重跑时，怎么把丢失的字段补回来？
改用定向补录：从源系统按记录ID导出缺失字段的值，整理成导入模板，只更新目标字段，避免整条记录覆盖已人工修正的内容。补录前先在少量记录上验证模板格式和字段对应关系，确认无误后再批量执行，并保留源导出文件与导入结果作为对账依据。操作前备份目标项目数据和映射配置，设定停止条件。
补回数据后，怎样才算确认恢复完成？
需要两层证据：字段级对账看单个字段质量，统计目标端受影响字段的非空率并与源端对比，比对枚举选项分布，按记录ID抽样逐条核对源值与目标值；全量校验看整体完整性，核对记录总数、关键字段完整性和工作项之间的关联关系。由业务负责人依据对账表、抽样记录和处置日志确认通过，再解除写入冻结，把冻结期间的变更补入并再次抽查。
ONES 的 Jira 迁移中，字段配置和字段值要分开核对吗？
需要分开。ONES 的 Jira 数据迁移包含迁移项目、系统配置（问题类型、工作流、字段配置、权限配置等）以及问题数据（属性和属性值、附件、评论等），字段配置迁移与字段值写入是两个环节。核对时先确认字段配置是否迁过来，再检查字段值是否正确写入，两类问题分开定位，避免把配置缺失误判为数据丢失。具体到某次字段丢失的补导方式，仍以实际迁移工具和服务约定为准。
