迁移验证的依据是一组可追溯的证据链：迁移前的基线快照、字段与对象映射记录、试迁移差异报告、正式迁移批次日志、业务抽样核对结果，以及切换与回退的判定记录。验证要围绕对象数量、字段取值、关联关系、权限与状态、业务可用性五类证据展开，每类证据都需回答三个问题：依据什么口径、由谁确认、出现偏差时按什么条件停止或回退。本文按验证范围、输入材料、核验维度、抽样分工、留痕格式和切换判定六个环节给出可执行的清单。
要点总览（TL;DR）
- 迁移验证的依据是一组可追溯的证据链：迁移前基线快照、字段与对象映射表、迁移批次日志、抽样核对结果和切换回退判定记录，缺项时对应结论只能标注为未验证。
- 核验围绕对象数量、字段取值、关联关系、权限与状态、业务可用性五类证据展开，每类都要写明取数方式、基线值、迁移后值和判定口径。
- 对象总数、附件数量、用户与权限映射适合全量核验；长文本保真、评论顺序、复杂关联适合按项目、类型、状态和时间分层抽样，偏差超阈值时扩大抽样直至全量核查。
- 验证记录按检查项登记执行人、时间、结果和附件位置，差异项分阻断、重要、观察三级，报告与迁移批次号绑定。
- 切换判定提前写清条件与决策人：阻断级差异清零且业务走查通过才可切换，数量差异超阈值、关键关联成批断裂或权限越权可见时暂停或回退。
验证对象与范围：先锁定来源、目标和迁移批次
验证范围与迁移范围错位，是迁移验收中最常见的返工原因。验证开始前，先把“验证什么”写成一份范围清单，逐项标注对象类型、来源系统、目标系统、迁移批次和责任人。清单之外的检查项不纳入本次结论，清单之内的检查项不得遗漏。
范围清单至少覆盖以下信息：
- 系统标识：来源系统与目标系统的产品名称、版本号、实例地址或环境标识。同一产品存在多个实例时，用实例标识区分，避免把测试实例的数据当作生产基线。
- 对象类型：工作项、需求、缺陷、文档、附件、评论、用户与权限，以及项目、迭代、版本等组织类对象。逐类标注是否纳入本次验证。
- 批次划分：本次迁移分几个批次、每批覆盖哪些项目或时间区间、各批次的迁移窗口。验证结论必须绑定到具体批次，不能用一个批次的通过结论覆盖其他批次。
- 排除项及原因：历史归档数据、已关闭项目的附件、外部系统嵌入内容等不纳入验证的内容，写明排除理由和后续处理安排。
范围清单需要迁移负责人和业务方共同确认。确认后的版本作为后续输入清单和核验证据表的引用基准，范围变更时同步更新版本号。
验证依据的输入清单：迁移前必须先备齐的材料
验证结论的可信度取决于输入材料是否齐备。以下五项输入在验证开始前必须到位，缺项时相应维度的验证结论不可采信，应标注为“未验证”而非“通过”。
| 输入材料 | 内容要求 | 提供方 | 版本要求 |
|---|---|---|---|
| 迁移前基线快照 | 对象总数、各状态数量、关键字段分布、附件与评论计数 | 来源系统管理员 | 迁移窗口开始前导出，记录导出时间 |
| 字段与对象映射表 | 来源字段到目标字段的对应关系、枚举值转换规则、必填与默认值处理 | 迁移实施方 | 与本次迁移批次对应的版本 |
| 迁移工具运行日志 | 批次号、开始与结束时间、成功与失败记录数、错误明细 | 迁移实施方 | 按批次归档 |
| 抽样规则与验收口径 | 抽样分层方式、样本量、通过标准、差异容忍范围 | 业务方与迁移负责人共同确认 | 验证开始前定稿 |
| 权限与账号对应关系表 | 来源账号到目标账号的映射、角色对应、特殊权限说明 | 系统管理员与业务方 | 与迁移批次一致 |
基线快照的导出时点尤其关键：它必须早于迁移写入动作，且与迁移日志的批次号能够对应。若基线在迁移过程中才补导，数量比对就失去参照意义。映射表同理，验证时使用的版本必须与实际执行迁移的版本一致，版本不一致时需说明差异并重新确认核验口径。
五类核验证据与判定口径
五类核验覆盖从“数据在不在”到“业务能不能用”的递进关系。前四类可以用脚本或查询完成，第五类必须由关键用户按真实流程操作。每类核验都要记录取数方式、基线值、迁移后值和判定结论。
| 核验维度 | 取数方式 | 通过标准 | 常见偏差 |
|---|---|---|---|
| 数量核验 | 按对象类型、状态、项目分类计数，与基线快照比对 | 总量与分类计数一致；存在差异时有逐条解释 | 附件重复计数、已删除对象被重新计入 |
| 字段核验 | 统计必填字段完整率、枚举值合法率，抽查长文本与富文本 | 必填字段完整率达到约定阈值；枚举值无非法值；富文本格式与图片保留 | 枚举值映射遗漏、富文本粘贴后样式丢失 |
| 关系核验 | 检查父子项、关联需求、依赖关系、外部链接是否成对保留 | 关联关系两端均存在，无单边悬挂 | 跨项目关联在分批迁移时断裂 |
| 权限与状态核验 | 比对角色映射表，抽查可见范围；检查工作流状态与历史记录 | 角色与可见范围符合映射表；状态流转历史完整；无越权可见 | 默认角色权限过宽、状态历史只保留最终状态 |
| 业务可用性核验 | 关键用户按真实流程走通一次，记录操作步骤与结果 | 关键流程可完成，结果符合业务预期 | 流程能走通但通知、统计等衍生结果异常 |
判定口径要在验证开始前写清楚，尤其是“允许差异”的边界。例如附件数量因去重规则产生的差异，需要有明确的去重规则说明和逐条对照；字段完整率低于阈值时，是判定不通过还是列入观察项，取决于该字段是否影响业务流程。口径模糊时，差异项容易在评审中被反复争论，延误切换窗口。
业务可用性核验不能只看页面能否打开。让关键用户用真实业务场景走一遍：新建一条需求并关联缺陷、走完一次状态流转、在文档中引用工作项、检查通知是否送达。走查结果按步骤记录，失败的步骤标注现象和影响范围。
抽样与全量核验怎么分工
全量核验保证“账能对上”，抽样核验解决“内容对不对”。两类检查的目标不同，混在一起做容易既慢又漏。
适合全量执行的检查项包括：对象总数与分类计数、附件数量、用户与权限映射、批次日志中的成功与失败记录数。这些检查可以用查询或脚本完成，成本低且结论明确，没有抽样的必要。
适合抽样的检查项包括：长文本与富文本内容保真、评论顺序与作者归属、复杂关联关系、历史状态记录。这些检查逐条人工核对成本高，抽样设计得当同样具备证明力。
抽样分层建议按项目、对象类型、状态、时间区间四个维度组合。例如：每个项目抽取若干条活跃需求、若干条已关闭缺陷、若干条含附件的文档，覆盖迁移窗口前后的时间区间。样本量根据对象总量和风险等级确定，高风险项目提高比例。复核人安排上，抽样结果由业务方复核，迁移实施方不单独确认自己执行的抽样。
抽样发现偏差后的处理规则要提前约定：单类样本偏差率超过约定阈值时，扩大该层抽样比例；扩大后仍超阈值，转为全量核查该类对象，并暂停后续批次的切换判定。这条规则的作用是防止用少量样本的“基本正常”掩盖系统性问题。
核验记录与证据留存格式
验证过程留痕的目的，是让未参与执行的人也能复核结论。每条证据记录以下字段：检查项名称、核验口径、执行人、执行时间、基线值、迁移后值、差异说明、判定结论、证据附件位置。附件包括查询结果导出、截图、日志片段，按批次号归档。
差异项单独登记，按影响分级：
- 阻断级：影响业务可用性或数据安全，例如权限越权可见、关键关联断裂，必须修复后才能切换。
- 重要级：影响部分数据完整性，例如个别富文本格式丢失，需有修复计划或业务方书面接受。
- 观察级：不影响使用的展示差异，记录后纳入切换后复查。
验证报告按“范围—输入—结果—未通过项—结论”的结构组织。范围部分引用S1的范围清单版本，输入部分列出各项材料的提供方与版本，结果部分按五类核验维度汇总，未通过项逐条对应差异登记表，结论部分明确本次批次是否具备切换条件。报告与迁移批次号绑定，批次变更时报告重新出具。
在实际执行中，验证记录、差异项和判定结论可以放在同一套协作工具里管理：把每个核验项登记为工作项，差异项作为独立工作项关联到对应批次，验证报告以文档形式与批次记录关联。ONES 的工作项与文档能力支持这种按批次组织证据的方式，便于复核人按检查项追溯执行人和结果，也便于切换评审时直接引用。
切换判定与回退条件
验证结果要转化成明确的行动决策：切换、暂缓还是回退。判定条件、阈值和决策人提前写进判定表，避免在切换窗口内临时讨论。
| 判定情形 | 条件 | 决策人 | 记录位置 |
|---|---|---|---|
| 可以切换 | 阻断级差异清零；重要级差异有结论或书面接受；业务走查关键流程通过 | 迁移负责人与业务负责人共同确认 | 切换判定记录，关联验证报告 |
| 暂缓切换 | 重要级差异未闭环，但影响范围可控；或抽样偏差触发扩大核查尚未完成 | 迁移负责人 | 暂缓说明与补验计划 |
| 必须回退 | 数量差异超过约定阈值且无法解释；关键关联成批断裂；出现权限越权可见 | 迁移负责人报业务负责人批准 | 回退记录，含触发条件与时间 |
回退窗口和回退前的数据保全动作要一并约定：回退前冻结目标系统的写入，导出回退时点的数据快照，记录回退原因和影响范围。回退不是失败结论，而是验证机制正常发挥作用的结果，记录完整才能支撑下一轮迁移的改进。
切换完成后设置短期观察期，观察项包括：关键业务流程的实际使用情况、权限相关的用户反馈、统计报表与通知是否正常、差异登记表中观察级项目的复查。复查时点建议安排在切换后一个完整业务周期结束时，由业务方确认观察结论并归档。
常见问题
基线快照在迁移开始后才补导，验证结论还能用吗？
补导的基线只能作为参考，不能作为数量比对的依据。基线快照必须在迁移写入动作之前导出，并记录导出时间，与迁移日志的批次号对应。若基线是迁移过程中或迁移后补导的，总量和分类计数已经包含迁移写入的影响，比对结果无法区分“迁移丢失”和“基线本身不准”。这种情况下，数量核验结论应标注为未验证，改用迁移日志中的成功记录数、失败明细和业务方抽样核对作为替代证据，并在验证报告中说明原因。
抽样核验发现偏差，什么情况下要停下来重新验证？
是否暂停取决于偏差的性质和扩散范围，建议在验证开始前就把规则写进抽样方案。单类样本偏差率超过约定阈值时，先扩大该层抽样比例；扩大后仍超阈值，转为该类对象的全量核查，并暂停后续批次的切换判定。出现权限越权可见、关键关联成批断裂这类阻断级问题时，无论样本量多少都应立即暂停，先定位原因再决定补验范围。个别富文本格式丢失等观察级差异，记录后纳入切换后复查即可，不必中断整体进度。
分批迁移时，前一批的验证结论能直接用于后一批吗？
不能直接沿用。验证结论与迁移批次绑定，每批的对象范围、映射表版本、迁移日志和抽样样本都不同。前一批的结论可以证明同类对象的迁移方法可行，但后一批仍需重新执行数量核验和业务走查，尤其是跨项目关联关系，在分批迁移时最容易出现两端不在同一批次而断裂的情况。实际操作中可以把前一批的核验项和取数脚本复用，减少重复工作量，结论仍需按批次重新出具。
业务可用性走查应该由谁执行，走查到什么程度算通过？
走查由关键业务用户执行，迁移实施方陪同记录，避免实施方自己确认自己迁移的结果。走查要按真实业务流程完整走一遍，例如新建需求并关联缺陷、完成一次状态流转、在文档中引用工作项、确认通知送达，逐步记录操作结果。通过标准是关键流程可以完成且结果符合业务预期，页面能打开但通知、统计等衍生结果异常的情况不算通过。走查失败的步骤要标注现象和影响范围，作为差异项登记。
回退之后，这一轮的验证记录还有保留价值吗？
有。回退记录本身就是验证机制正常发挥作用的结果，需要完整保留触发条件、回退时间、回退前的数据快照和影响范围。这些记录是下一轮迁移改进的直接输入：哪些核验项没有提前发现该问题、抽样方案是否需要调整、映射表哪部分需要修订，都可以从回退记录中回溯。建议把回退记录与对应批次的验证报告关联归档，下一轮迁移启动时先复查上一轮的回退原因是否已闭环。
