数据迁移自检表：换库换结构前的核对

数据迁移的风险往往不在搬迁本身，而在“以为搬完了”。用一张自检表把不确定项提前暴露，比事后补数据省力得多。

一、盘点：先弄清有什么
列出所有数据来源：主库、附属库、文件存储、缓存、第三方导入。对每张表记录行数量级、更新频率、是否含敏感字段、是否有外部依赖。找出没有主键或主键不唯一的表，找出用字符串存日期的字段，找出靠约定而非约束维持的关联关系。把这些“隐性规则”写成文字，它们是迁移中最容易丢失的部分。同时确认哪些数据可以丢弃、哪些必须保留、保留多久。

二、映射：把旧结构翻译成新结构
为每个字段建立映射：直接对应、需要转换、需要拆分、需要合并、无对应需新增。对需要转换的字段写明转换规则与边界值处理，例如空值、超长文本、异常编码。枚举类字段要列出全部旧值到新值的对照，未覆盖的值要有默认策略并记录。时间字段统一时区与精度。金额字段统一单位与小数位。为每张表指定负责人，映射表要能被非开发人员读懂。

三、演练：在真实体量上跑一遍
用小样本验证逻辑，再用接近生产的数据量验证耗时与资源占用。记录每个阶段的开始与结束时间，找出瓶颈。演练必须包含“中断后续跑”的场景，确认迁移任务可重入、不重复写入。检查迁移期间的写入如何处理：是停写、双写还是增量补齐，每种方案都要写明切换窗口与影响范围。

四、校验：用可复现的方式证明对得上
校验分三层：总量核对、抽样逐字段核对、关键业务口径核对。总量核对看行数与主键集合差异；抽样核对看转换规则是否按预期执行；业务口径核对看汇总值是否一致。为每层校验准备可重复执行的脚本，输出差异清单而不是一句“通过”。差异要分类：可解释的、需修复的、需业务确认的。

五、回滚与收尾
确认回滚条件、回滚步骤、回滚所需时间，并在演练中实际执行一次。切换后保留旧数据只读一段时间，便于比对。收尾阶段清理临时表与迁移脚本，更新文档，记录本次遇到的坑与处理方式。注意事项：涉及个人信息的数据在迁移与抽样校验中应脱敏；任何“先上线再补”的决定都要写明补救责任人与时限。