迁移时遇到字段对不上，先别急着改数据。枚举值差异、必填约束差异、类型与长度差异是三类不同的问题，分别对应取值域映射、数据完整性缺口和格式承载问题。本文按“识别症状—排查归类—分类型处置—验证防复发”的顺序，帮你把每个不一致项落到可自动转换、需人工决策或需阻断迁移三类中，再决定转换规则、默认值策略或阻断清单。
要点总览（TL;DR）
- 先按三类归因：枚举值差异属于取值域映射问题，必填约束差异属于数据完整性缺口，类型与长度差异属于格式承载问题。
- 排查顺序固定为：盘点源与目标字段约束、抽样比对真实数据分布、按可自动转换/需人工决策/需阻断迁移三类归档并留存证据。
- 枚举值处置围绕显式映射表展开，多对一合并须业务确认语义等价，无对应值可选新增目标枚举、兜底加待复核标记或阻断记录。
- 必填与格式类处置涉及补默认值、转换回退、截断与阻断，批量改写前先备份并设置分批停止点，禁止静默截断。
- 用小批量试迁移核对记录数、空值率、枚举分布与截断条数，通过后把映射表和约束差异清单纳入迁移资产复用。
不一致在迁移中表现成哪些症状
字段约束不一致在迁移过程中会以不同形式暴露出来。先看清症状，才能判断问题属于哪一类，避免把数据内容问题误当成工具或流程故障去排查。
| 症状表现 | 对应不一致类型 | 初步判断依据 |
|---|---|---|
| 源字段取值在目标枚举集合中找不到匹配项，记录被置空或落到兜底值 | 枚举值不一致（取值域映射问题） | 对比源枚举集合与目标枚举集合，存在源有目标无的取值 |
| 目标字段必填但源数据为空，迁移报错或记录被跳过 | 必填约束不一致（数据完整性缺口） | 目标字段必填标记为真，源侧对应字段空值率大于零 |
| 源字段必填而目标字段可空，迁移后该字段的强制填写语义消失 | 必填约束不一致（语义丢失） | 源侧必填标记为真，目标侧为可空，且该约束承载业务规则 |
| 文本被截断、日期或数值格式转换失败、小数精度丢失 | 类型与长度不一致（格式承载问题） | 源字段长度上限或类型与目标字段不同，抽样中出现超限或转换异常 |
需要区分的是，上述症状都指向数据内容层面的不一致。如果迁移中出现整批记录未写入、字段整体缺失、状态流转异常等现象，更可能是迁移流程配置或插件行为导致，应先排查工具侧配置，本文讨论的范围限于字段取值、完整性与格式本身的不一致。
按什么顺序排查并归类这些不一致
排查的核心思路是先用约束清单建立对照，再用真实数据验证影响面，最后按处置难度归档。顺序不能颠倒：跳过约束盘点直接看数据，容易漏掉低频但关键的枚举值；只看约束不看数据分布，则无法判断问题规模。
第一步：盘点源与目标字段约束
逐字段整理一张对照清单，至少包含：字段名称、数据类型、长度上限、枚举集合（含每个取值的含义）、是否必填、默认值。这张清单是后续所有判断的基准，也是迁移资产的一部分。盘点时以系统配置为准，不凭记忆或旧文档填写。
第二步：抽样比对真实数据分布
从源数据中按业务类型分层抽样，统计每个字段的空值率、超出目标长度上限的记录数、不在目标枚举集合内的取值及各自出现频次。抽样要覆盖历史数据和近期数据，老数据往往存在已废弃的枚举值。统计结果用于判断影响面：出现频次高的不一致项优先处理，频次极低但语义重要的项列入人工确认。
第三步：按三类归档并留存证据
| 归档类别 | 判定条件 | 所需证据 | 责任角色 |
|---|---|---|---|
| 可自动转换 | 源取值与目标取值存在明确一对一关系，或类型转换规则确定且无精度损失 | 字段约束清单、映射关系说明 | 迁移执行人员 |
| 需人工决策 | 存在多对一合并、无对应枚举值、必填字段需补默认值等需要业务判断的情况 | 抽样统计结果、业务确认记录 | 业务负责人与数据负责人 |
| 需阻断迁移 | 无法确定映射关系、补默认值会改变业务含义、截断会造成关键信息丢失 | 影响面统计、阻断原因说明 | 迁移负责人审批 |
归档时要把假设和证据分开记录。例如“这个枚举值应该可以合并到目标值”只是假设，需要业务方书面确认语义等价后才能归入可自动转换；未经验证的猜测应暂列人工决策，不写成结论。
枚举值不一致怎么处置
枚举值问题的处置围绕一张显式映射表展开。映射表逐条列出源枚举值、目标枚举值、映射类型（一对一、多对一、无对应）和确认人，作为转换规则的唯一依据。
- 一对一映射：语义一致、仅名称或编码不同，直接写入映射表，可自动转换。
- 多对一合并：多个源取值合并到同一目标取值，必须先由业务方确认这些取值在业务上等价。合并后如需保留区分，可在目标侧增加标记字段记录原值。
- 无对应值：有三种处理选项。其一，在目标系统中新增枚举值，适用于该取值仍有业务意义的情况；其二，映射到兜底值并打上待复核标记，适用于低频且不影响流程判断的取值；其三，阻断该记录进入迁移，适用于取值含义不明或涉及合规判断的情况。
处置前备份源数据，映射表按版本管理，每次调整记录变更人和变更原因。迁移执行到映射表覆盖范围之外的数据时设置停止点，暂停并补充映射，避免兜底值被大量静默写入。
必填约束与类型长度不一致怎么处置
这类问题涉及数据完整性和格式承载，处置动作可能改写或丢弃数据，需要逐场景确认风险边界。
| 场景 | 处置方式 | 风险 | 停止条件 |
|---|---|---|---|
| 目标必填而源为空 | 按业务规则补默认值；从关联字段推导；或列入人工补录清单 | 默认值可能掩盖真实缺失，影响后续统计 | 补默认值比例超过约定阈值时暂停，转人工确认 |
| 源必填而目标可空 | 确认该约束是否承载业务规则；必要时在目标侧保留标记字段 | 强制填写语义丢失，流程校验失效 | 该字段参与审批或流转判断时，须先确认替代校验方式 |
| 类型不一致 | 明确转换规则，约定转换失败时的回退方式（保留原值、记入异常清单） | 日期、数值转换失败导致记录不可用 | 转换失败率超过约定比例时暂停批量执行 |
| 长度超限 | 截断前确认业务可接受性，保留原值备查；不可接受时改为阻断或扩展目标字段长度 | 关键信息丢失且难以追溯 | 禁止静默截断，截断记录须逐条可查 |
涉及批量改写或删除的操作，执行前完成源数据备份，并设置分批执行的停止点：每批完成后核对改写条数与异常条数，确认无误再继续下一批。人工补录清单要明确责任人和完成时限，补录完成前相关记录不进入正式迁移批次。
如何验证处置结果并防止复发
处置规则确定后，先用小批量数据试迁移验证，再全量执行。试迁移样本应覆盖每一类不一致场景，包括多对一合并、无对应值兜底、必填补默认值和长度截断的记录。
试迁移核对清单
- 记录数：源侧应迁移条数与目标侧实际写入条数一致，差额能逐条解释。
- 空值率：目标必填字段的空值率与补默认值策略的预期一致，无未解释的置空。
- 枚举分布：目标侧各枚举值的记录数与映射表预期一致，兜底值记录均有待复核标记。
- 截断条数：截断记录数与异常清单一致，无静默截断。
- 阻断清单：每条阻断记录都有结论，要么补充映射后放行，要么确认不迁移并记录原因。
通过标准是上述各项全部可解释、可追溯。任何一项存在无法说明的差异，都应回到对应处置环节修正规则后重新试迁移。
复发预防
把字段约束对照清单、枚举映射表和阻断清单纳入迁移资产库，后续同类迁移直接复用并在此基础上增量修订。同时在源系统侧建立字段约束变更的通知机制：新增枚举值、调整必填标记或修改长度上限时，通知迁移负责人评估对目标侧的影响。迁移过程中产生的映射表、阻断清单和人工补录记录需要在团队协作工具中登记、评审并跟踪状态，ONES 的文档与工作项管理可以承载这类清单的版本记录和责任人跟踪，使每次迁移的决策依据可查、可交接。
常见问题
源字段和目标字段的枚举值只是名称不同，还需要业务确认吗？
名称或编码不同、语义明确一致的一对一关系，可以直接写入映射表并归入可自动转换，由迁移执行人员依据字段约束清单确认即可。需要业务确认的是多对一合并和含义存疑的取值：多个源取值合并到同一目标取值时，要由业务方书面确认这些取值在业务上等价；含义不明或涉及合规判断的取值，即使出现频次很低，也应先列入人工决策，不凭猜测写入映射表。
目标字段必填而源数据大量为空，全部补默认值可以吗？
补默认值适用于业务规则明确、默认值不改变记录含义的场景。执行前先统计空值比例和分布，如果空值集中在某类历史数据或某个业务环节，说明缺失有结构性原因，应优先从关联字段推导或列入人工补录清单。补默认值比例超过事先约定的阈值时暂停批量处理，转人工确认，避免默认值掩盖真实缺失、影响后续统计和流程判断。
长度超限的记录直接截断有什么风险，怎么控制？
截断会丢失尾部信息，如果被截掉的是描述、备注或编号中的关键内容，后续很难追溯。处置前先确认业务上是否可接受截断，可接受时保留原值备查并逐条登记截断记录；不可接受时改为阻断该记录或评估扩展目标字段长度。无论哪种方式，都不允许静默截断，试迁移核对时要保证截断条数与异常清单完全一致。
阻断迁移的记录后续怎么处理，会不会一直悬着？
阻断清单需要逐条闭环：要么补充映射关系或补齐数据后放行，要么确认该记录不迁移并记录原因和审批人。每条阻断记录都应指定责任人和处理时限，处理结论回写到清单中。试迁移阶段就要检查阻断清单是否全部有结论，存在未闭环项时不进入全量迁移。
这次整理好的映射表和约束清单，下次迁移还能用吗？
可以，而且应当作为迁移资产保留。字段约束对照清单、枚举映射表和阻断清单按版本管理，记录变更人和变更原因，后续同类迁移在此基础上增量修订，减少重复盘点。同时在源系统侧建立字段约束变更的通知机制，新增枚举值、调整必填标记或修改长度上限时通知迁移负责人评估影响，降低复发概率。这类清单的登记、评审和责任人跟踪可以放在 ONES 的文档与工作项中管理，使决策依据可查、可交接。
