迁移完成后发现字段为空、值错位或部分记录缺失，先不要急着重跑。字段丢失可能发生在源导出、映射配置、写入目标或页面展示中的任一环节，不同环节的处置方式差别很大。本文按“定位环节—验证原因—受控处置—验证与预防”的顺序，给出一套可执行的排查路径，适用于工作项、文档等数据从旧系统迁入新系统的场景。
要点总览（TL;DR）
- 字段丢失先定位环节：源导出、映射配置、写入目标、页面展示，四类现象对应不同排查方向。
- 按假设逐项验证：迁移范围与过滤条件、映射缺失或错位、源数据质量、目标字段约束、权限与接口限制，每条结论都要有证据。
- 处置以补齐映射、清洗源数据、预校验目标约束为主；重跑前保留源数据快照与迁移日志，限定重跑范围并设置错误率停止点。
- 恢复验证用分层抽样核对加总量统计（记录数、非空率、枚举分布、长文本完整性）双线确认。
- 把修正后的字段映射表固化为模板并纳入变更评审，迁移前用样本数据试迁移，降低再次丢失的概率。
字段丢失出现在哪一层：症状与范围界定
“字段丢了”是一个笼统描述，排查第一步是把它拆成可观察的具体现象，并确定影响范围。建议从目标系统侧取证：打开若干条记录，记录哪些字段为空、哪些字段有值但内容明显属于另一个字段、哪些记录整条缺失、哪些长文本只剩前半段。这四类现象对应的排查方向并不相同。
| 丢失环节 | 典型表现 | 影响范围特征 | 优先核查对象 |
|---|---|---|---|
| 源导出 | 源系统有值，导出文件中该列为空或缺失 | 通常按字段成片出现，与记录无关 | 导出模板、导出查询条件、源字段权限 |
| 映射配置 | 目标字段为空，或值出现在另一个字段里 | 按字段对应关系成组出现 | 字段映射表、同名不同义字段 |
| 写入目标 | 部分记录写入失败，或值被截断、清空 | 与记录特征相关，如超长、格式特殊 | 目标字段类型、长度、必填与枚举约束 |
| 页面展示 | 数据已入库，但列表或详情页不显示 | 按视图、权限或字段配置出现 | 页面字段配置、视图筛选、字段级权限 |
范围界定决定排查成本。全量丢失通常指向配置类问题，例如映射表整体缺项、导出模板漏列、目标字段被设为不可写；个别记录丢失则更可能与源数据质量、过滤条件或单条写入失败有关。两类情况的排查顺序相反：前者先查配置，后者先查样本记录。
在动手修改任何配置之前，先建立对照基线。抽取20至50条记录，覆盖不同工作项类型、不同时间段和不同字段类型，把源值与目标值并排列出。这张对照表是后续所有原因验证的共同依据，也能在修复后直接复用为验证样本。抽样时特意纳入长文本、含特殊字符、枚举值和空值记录，能更早暴露边界问题。
原因假设与排除证据：逐项验证字段丢失来源
定位到环节后，下一步是把可能原因列成假设，逐项寻找支持或排除的证据。原因型排查的关键是区分“看起来像”和“已验证”：每条假设都要有对应的检查动作和可记录的结论，避免凭经验直接下判断。
| 原因假设 | 验证方法 | 支持结论的证据 | 排除结论的证据 |
|---|---|---|---|
| 映射缺失 | 对照映射表与源、目标字段清单，逐字段勾对 | 目标字段在映射表中无对应项 | 映射表覆盖完整，且抽样记录该字段有值 |
| 映射错位 | 检查同名不同义字段是否被自动匹配 | 目标字段值语义与源字段不符 | 错位字段修正后抽样值一致 |
| 源数据为空或格式不合法 | 统计源字段非空率，检查日期、数值格式 | 源端该字段本身为空或格式异常 | 源端有值且格式规范，导出文件同样有值 |
| 特殊字符导致解析失败 | 检索含引号、换行、分隔符的记录 | 失败记录集中在含特殊字符的样本 | 含特殊字符的记录正常写入 |
| 目标字段约束 | 核对字段类型、长度上限、必填与枚举选项 | 被截断或拒绝的记录均超出约束 | 同长度、同类型记录写入正常 |
| 迁移范围与过滤条件 | 核对查询条件、时间窗口、状态过滤 | 缺失记录恰好落在过滤条件之外 | 缺失记录在迁移范围内仍丢失 |
| 权限与接口限制 | 检查源字段可读权限、目标字段可写权限 | 缺失字段在权限配置中被限制 | 同等权限下其他字段迁移正常 |
建议的排除顺序是：先查迁移范围与过滤条件，因为这类问题影响面大且验证成本低；再查映射配置，对照映射表即可完成；然后查源数据质量与目标字段约束，需要逐条比对样本；最后查权限与接口限制，这类问题往往表现为静默丢弃，日志中不一定有明确报错，需要结合权限配置和接口返回结果判断。
验证过程中要区分“字段未映射”和“映射了但值没写进去”。前者在映射表中就能看到缺口；后者需要查看写入环节的返回结果或错误记录。如果目标系统对超长文本做截断处理而不报错，截断现象容易被误判为映射问题，此时对比源值与目标值的长度即可区分。每排除一条假设，都应在排查记录中写明检查对象、检查结果和结论，便于后续复盘和交接。
按原因处置：补齐映射、清洗数据与受控重跑
原因确认后，处置动作应尽量小范围、可回退。优先修正配置和清洗数据，再考虑重跑；重跑前必须完成备份和范围限定，避免二次写入造成重复数据或覆盖已有正确值。
补齐或修正字段映射。按映射表逐项补上缺失字段，重点处理同名不同义的情况，例如源系统的“负责人”与目标系统的“经办人”语义不同，不能直接按名称匹配。类型不匹配的字段要明确转换规则，如单选转多选、文本转枚举，转换规则应写入映射表备注，便于复核。
清洗源数据。对空值区分“源端确实为空”和“导出时丢失”，前者按业务规则决定是否补默认值，后者回到导出环节修复。格式不合法的日期、数值先统一格式；含引号、换行、分隔符的内容做转义处理；超长文本按目标字段长度上限截取或拆分到扩展字段，并在清洗记录中标注处理方式。
对目标字段约束做预校验。在正式写入前，用清洗后的样本数据跑一遍校验，检查必填字段是否有值、枚举值是否在选项范围内、长度是否超限。预校验能提前发现会被拒绝的记录，减少重跑轮次。
重跑前保留快照与日志。对源数据做完整快照，保留本次迁移的配置、映射表和运行日志。重跑范围限定为受影响的记录集合，例如按时间窗口或记录ID清单圈定，避免全量重跑引入新的重复或覆盖。若目标系统已有部分正确数据，明确重跑是覆盖还是跳过已存在记录。
设置停止点。为本次重跑设定错误率阈值，例如异常记录占比超过预设比例时暂停迁移，检查原因后再决定继续或回退。回退方案应在重跑前确认可用，包括如何撤销本次写入的记录。
验证恢复与复发预防
重跑结束不等于问题解决，需要用抽样核对和总量统计两条线确认字段已完整恢复。抽样按字段类型和记录类型分层：文本、长文本、日期、数值、枚举各抽若干条，工作项、文档等不同记录类型分别覆盖，逐条比对源值与目标值。总量统计则对比记录数、字段非空率、枚举值分布，与源端数据做同口径比较，发现抽样未覆盖的系统性偏差。
| 验证项 | 核对方法 | 通过标准 |
|---|---|---|
| 记录数 | 目标记录数与源端迁移范围内记录数对比 | 数量一致，差异有明确说明 |
| 字段非空率 | 按字段统计目标端非空比例，与源端对比 | 差异在可解释范围内 |
| 枚举分布 | 统计状态、类型等枚举字段的取值分布 | 分布与源端一致，无异常集中 |
| 长文本完整性 | 抽查长文本首尾内容与长度 | 内容完整，无截断 |
| 关联关系 | 抽查父子项、关联工作项是否保持 | 关联关系与源端一致 |
复发预防从三件事入手。第一，把本次修正后的字段映射表固化为可复用模板，后续同类迁移直接套用，映射表变更纳入评审，避免临时修改绕过检查。第二，迁移前用样本数据做试迁移，把字段校验加入验收清单，试迁移通过后再执行正式迁移。第三，记录本次丢失的原因、处置过程和验证结果，形成复发预防条目，例如“含换行符的文本字段必须转义后写入”“枚举字段迁移前核对选项映射”。
在协作工具中承载这套流程，可以把映射表、迁移任务和验证记录放在同一处管理。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，并可迁移问题类型、工作流、字段配置、权限配置以及属性和属性值等信息，迁移前需要确认数据范围和字段配置的实际覆盖情况。把字段映射表作为文档维护、迁移任务作为工作项跟踪、验证核对结果附在任务下，能让排查结论、责任人和重跑范围有据可查，减少同类问题在后续迁移中重复出现。
常见问题
只有个别记录字段丢失，还需要全量重跑吗？
通常不需要。个别记录丢失更可能与源数据质量、过滤条件或单条写入失败有关，先按记录ID圈定受影响集合，只对这批记录做受控重跑。全量重跑会扩大影响面，还可能覆盖目标系统中已经正确的数据。若排查后发现是映射表整体缺项这类配置问题，才需要评估更大范围的重跑。
源系统里字段本身为空，迁移后目标字段也为空，这算字段丢失吗？
这属于源端数据本身为空，不算迁移丢失。判断方法是统计源字段的非空率，并核对导出文件中该字段是否同样为空。若源端有值而导出文件为空，问题在导出环节；若源端本身为空，则按业务规则决定是否补默认值，并在清洗记录中标注处理方式，避免与真正的丢失混在一起统计。
重跑时如何避免产生重复数据或覆盖已有正确值？
重跑前明确三件事：重跑范围（按时间窗口或记录ID清单圈定）、写入策略（覆盖还是跳过已存在记录）、回退方案（如何撤销本次写入）。同时保留源数据完整快照和本次迁移的配置、映射表与运行日志。重跑过程中设置错误率阈值，异常记录占比超过预设比例时暂停，检查原因后再决定继续或回退。
长文本字段只迁移了前半段，应该从哪里查？
先对比源值与目标值的长度，确认是截断还是内容缺失。若目标端长度恰好等于目标字段的长度上限，说明是目标字段约束导致的截断，需要调整字段长度或把超长内容拆分到扩展字段；若长度无明显规律，则检查导出与解析环节是否因换行、引号等特殊字符中断。截断通常不报错，容易被误判为映射问题，长度对比是最快的区分方法。
字段映射表怎样管理才能减少后续迁移再次出错？
把本次修正后的映射表固化为可复用模板，同名不同义字段、类型转换规则都写入备注；映射表变更纳入评审，避免临时修改绕过检查。迁移前用样本数据做试迁移，把字段校验加入验收清单。在协作工具中，可以把映射表作为文档维护、迁移任务作为工作项跟踪、验证结果附在任务下，让结论、责任人和重跑范围有据可查。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，并可迁移问题类型、工作流、字段配置、权限配置以及属性和属性值等信息，迁移前需确认数据范围和字段配置的实际覆盖情况。
