迁移后发现字段缺失，常见原因集中在四段：源端没有把字段导出、导出数据没有进入映射、目标端字段类型或长度不兼容、导入过程被截断或跳过。排查时先确认丢失发生在哪一段，再用少量样本记录逐段比对，针对原因修复后做回归验证，避免把界面展示不全误判成数据丢失。
要点总览（TL;DR）
- 迁移字段丢失通常发生在四个环节：源端未导出、映射未建立、目标端类型或长度不兼容、导入过程被截断或跳过。
- 排查从定位丢失环节开始：先抽取少量样本记录建立比对基线，再按源端、映射、目标端、过程的顺序逐类排除。
- 处置前先备份源数据与目标端现状，修正映射或字段配置后用小批量样本重跑，覆盖写入前设定停止条件并二次确认。
- 恢复验证需要记录数、字段非空率、抽样比对三类证据；把映射表固化为可复用配置，并在迁移前做字段清单核对与试迁移。
字段丢失出现在哪一段：症状与范围界定
字段丢失是一个笼统说法，实际可能发生在导出、映射、导入、展示四个不同环节。定位的第一步是把“看不到字段”拆成可观察的症状，再判断它属于哪一类。不同环节的症状差异明显，先分清类型能避免在错误的方向上排查。
| 环节 | 典型症状 | 初步判断依据 |
|---|---|---|
| 源端导出 | 导出文件中缺少该列，或整列为空 | 直接打开导出文件核对表头与行数据 |
| 映射 | 导出文件有该列，目标端对应字段始终为空 | 对照映射表，确认源字段是否绑定目标字段 |
| 目标端写入 | 导入报错、部分记录写入失败，或值被截断 | 查看导入日志与失败记录明细 |
| 界面展示 | 数据已写入，但列表或详情页不显示该字段 | 通过查询或导出目标端数据确认值是否存在 |
建立比对基线时，从源数据中抽取少量样本记录，建议覆盖不同工作项类型、不同创建时间和不同字段取值情况，记录每条样本在各环节的字段值。样本量不必大，关键是能代表受影响的数据范围。基线建立后，后续每一步排查都以这批样本为准，避免全量比对带来的时间成本。
确认影响范围同样重要。需要区分三种情况：只有单个字段丢失、某一类工作项的多个字段丢失、还是全量数据普遍缺失。单字段问题多指向映射或字段配置；单类工作项问题多指向导出范围或视图过滤；全量缺失则更可能与导入中断、编码或整体配置有关。范围判断会直接缩小后续假设的范围。
常见原因假设与排除证据
原因排查要区分假设与已确认结论。下面按源端、映射、目标端、过程四类列出常见假设，每类给出验证方法和判定证据，建议按“源端→映射→目标端→过程”的顺序排除，因为前一段的问题会掩盖后一段的表现。
源端原因
最常见的是字段没有纳入导出范围。导出时选择了字段子集、使用了默认模板，或按视图过滤导出，都会导致部分字段没有带出。验证方法是直接检查导出文件的表头，确认目标字段是否在列。若表头缺失，基本可判定为导出范围问题。
权限与视图过滤是容易被忽略的假设。某些字段对当前导出账号不可见，或视图本身过滤掉了含该字段值的记录，导出结果就会表现为整列为空或记录缺失。验证时换用具备完整字段权限的账号重新导出，或去掉视图过滤条件对比结果。若两次导出差异明显，可确认是权限或过滤导致。
映射原因
源字段与目标字段未建立对应关系，是字段“消失”的典型原因。导出文件里有数据，但映射表没有把该列绑定到目标字段，导入时这一列就被忽略。验证方法是逐列核对映射表，确认每个源字段都有明确的目标字段指向。
同名不同义被错配也会造成看似丢失的现象。两个字段名称相同但含义不同，映射时绑到了错误的字段，原字段的值写入了另一个位置。验证时抽取样本记录，比对源值与目标端实际写入位置，确认值是否“跑到了别处”。这类问题表现为目标字段为空、其他字段出现异常值，需要结合样本比对才能发现。
目标端原因
字段类型、长度、必填约束或选项集不兼容，会导致写入被拒绝或值被截断。例如源端是长文本、目标端是短文本，超出部分会被截断；源端是自由输入、目标端是固定选项集，不在选项内的值可能写入失败。验证方法是查看导入日志中的失败记录和错误提示，确认是否存在类型或长度相关的报错。
必填约束同样会造成记录级失败。目标字段设为必填但映射未提供值，整条记录可能被跳过，表现为该记录所有字段都缺失。验证时检查失败记录是否集中在特定字段为空的情况，并核对目标端字段的必填配置。
过程原因
分批导入中断是批量迁移中的常见问题。导入进行到中途因超时、网络或数据异常停止，已处理批次写入、未处理批次缺失，表现为部分记录完整、部分记录缺失。验证方法是比对源端与目标端的记录总数，并检查导入日志的批次完成情况。
编码问题会导致特殊字符字段出现乱码或写入失败，重复数据覆盖则可能让后导入的记录覆盖先导入的记录，造成字段值被替换。验证时检查含特殊字符的样本记录，以及目标端是否存在重复记录和值被覆盖的痕迹。
| 原因类别 | 验证方法 | 判定证据 |
|---|---|---|
| 导出范围 | 检查导出文件表头 | 目标字段不在列或整列为空 |
| 权限/视图过滤 | 换账号或去过滤重新导出对比 | 两次导出结果差异明显 |
| 映射缺失 | 逐列核对映射表 | 源字段无目标字段指向 |
| 同名错配 | 样本值比对写入位置 | 值出现在其他字段 |
| 类型/长度不兼容 | 查看导入日志报错 | 存在截断或类型错误提示 |
| 必填约束 | 核对失败记录与字段配置 | 失败集中在必填字段为空 |
| 分批中断 | 比对记录总数与批次日志 | 部分批次未完成 |
| 编码/重复覆盖 | 检查特殊字符样本与重复记录 | 乱码或值被替换 |
排除顺序建议从源端开始：先确认导出文件是否包含目标字段，再确认映射是否完整，然后检查目标端配置是否兼容，最后排查导入过程是否完整。每排除一类，就在假设清单上记录证据，避免重复排查同一方向。
按顺序处置：从定位到修复
处置的前提是保留可回退点。在动手修改前，先备份源数据导出文件和目标端当前数据，记录当前映射表与字段配置的版本。备份的作用是当修复引入新问题时能回到已知状态，尤其是涉及覆盖写入的场景。
第一步是逐段复现。用之前建立的样本记录，按导出、映射、导入的顺序重新走一遍，在每一段记录字段的实际状态。复现的目的是把“哪里丢了”变成可观察的事实，而不是停留在推测。复现过程中保留每一步的中间文件，便于后续比对。
第二步是修正配置。根据复现结果定位到具体环节后，修正映射表或字段配置：补上缺失的字段对应关系、调整目标字段的类型或长度、补充必填字段的默认值、修正选项集映射。修改时记录改动内容，便于回退和复核。
第三步是小批量重跑。修正后用少量样本记录重新导入，确认字段能完整写入，再逐步扩大批量。小批量重跑能在一开始就暴露配置问题，避免全量导入后才发现错误。
涉及覆盖写入时需要设定停止条件。建议在以下情况暂停操作：样本重跑仍出现字段缺失、导入日志出现新的错误类型、目标端记录数异常变化。暂停后先复核配置与备份，确认原因再继续。覆盖写入前应做二次确认，明确覆盖范围和影响记录，避免误覆盖已有数据。
在迁移过程需要留痕和复核的场景中，可以把字段对照关系、迁移批次记录和复核结论放在同一套工作项与文档中管理。ONES 支持工作项字段配置和迁移记录的管理，团队可以在其中维护字段映射清单、记录每批导入的状态，并把复核结果关联到对应工作项，让处置过程有据可查。
验证恢复与防止复发
字段是否真正恢复，需要三类证据共同支撑。记录数比对确认数据量完整，字段非空率确认目标字段有值，抽样比对确认值与源端一致。三类证据缺一不可：记录数一致但字段为空，说明映射仍有问题；字段有值但抽样不一致，说明存在错配或截断。
- 记录数：源端与目标端总数一致，分批导入的各批次均已完成。
- 字段非空率：目标字段的非空比例与源端接近，无明显异常空缺。
- 抽样比对：抽取覆盖不同工作项类型和字段取值的样本，逐条核对值的一致性。
验证通过后，把映射表与字段对照关系固化为可复用配置。下次迁移同类数据时直接调用，减少重新配置带来的遗漏。配置中应包含源字段、目标字段、类型转换规则和必填处理方式，并标注版本和适用范围。
预防复发的关键在于迁移前的预检。预检内容包括：核对源端与目标端的字段清单，确认每个字段都有明确的映射或明确的排除理由；执行一次小规模试迁移，验证字段完整性和值的一致性；检查目标端字段的类型、长度和必填配置是否与源数据匹配。试迁移通过后再执行全量迁移。
最后明确责任人与复核时点。迁移执行人负责预检和过程记录，复核人在试迁移后和全量导入后各做一次确认，复核结论与迁移记录一并留存。把复核时点固定在迁移流程的关键节点上，能让字段完整性问题在造成影响前被发现。
常见问题
导出文件里字段有值，导入后目标字段却为空，最可能是什么原因？
这种情况通常指向映射环节。导出文件包含该列，说明源端导出正常；目标字段为空，说明导入时这一列没有被写入目标字段。常见原因是映射表没有把该源字段绑定到目标字段，或者绑到了名称相同但含义不同的另一个字段。
排查时先逐列核对映射表，确认源字段有明确的目标字段指向；再抽取样本记录，比对源值与目标端实际写入位置，确认值是否被写到了其他字段。若映射完整且值确实写入了别处，按同名错配处理，修正绑定关系后小批量重跑验证。
只有某一类工作项的字段丢失，其他类型正常，应该先查哪里？
单类工作项出现字段丢失，优先检查导出范围和视图过滤。导出时按工作项类型选择字段子集、使用默认导出模板，或按视图过滤导出，都可能让该类工作项的字段没有带出。验证方法是直接打开导出文件，核对该类工作项的表头是否包含目标字段。
若表头存在但整列为空，再检查导出账号对该字段的权限，以及视图是否过滤掉了含该字段值的记录。换用具备完整字段权限的账号或去掉过滤条件重新导出，对比两次结果即可确认。单类问题一般不需要先怀疑导入中断，全量缺失才更可能与过程原因相关。
导入日志没有明显报错，字段却出现部分记录缺失，怎么排查？
没有报错不代表导入完整。先比对源端与目标端的记录总数，并检查导入日志中各批次的完成状态，确认是否存在分批导入中断：已处理批次写入、未处理批次缺失，表现就是部分记录完整、部分记录缺失。
若记录数一致，再检查重复数据覆盖的痕迹。后导入的记录覆盖先导入的记录时，字段值可能被替换，日志中未必有错误提示。可以抽取缺失记录，确认目标端是否存在同标识的重复记录，以及值是否被其他批次写入的内容替换。含特殊字符的字段还要检查编码问题导致的乱码或写入失败。
修复映射后重新导入，如何避免覆盖已有数据造成二次损失？
重新导入前先备份目标端当前数据，并记录映射表与字段配置的版本，保留可回退点。修复后先用少量样本记录重跑，确认字段能完整写入，再逐步扩大批量，避免全量导入后才发现配置仍有问题。
涉及覆盖写入时设定停止条件：样本重跑仍出现字段缺失、导入日志出现新的错误类型、目标端记录数异常变化，任一情况出现即暂停，复核配置与备份后再继续。覆盖前做二次确认，明确覆盖范围和受影响记录，把覆盖操作与迁移批次记录一并留存，便于事后追溯。
字段恢复后，怎样确认迁移结果可以进入下一阶段？
用三类证据共同确认：源端与目标端记录数一致且各批次均已完成；目标字段的非空比例与源端接近，无明显异常空缺；抽取覆盖不同工作项类型和字段取值的样本，逐条核对值与源端一致。记录数一致但字段为空，说明映射仍有问题；字段有值但抽样不一致，说明存在错配或截断。
验证通过后，把映射表与字段对照关系固化为可复用配置，标注版本和适用范围。后续迁移前执行预检：核对两端字段清单、确认每个字段有映射或明确的排除理由、做一次小规模试迁移。复核时点固定在试迁移后和全量导入后，结论与迁移记录一并留存。
