研发数据迁移校验规则要能逐条判定“迁得对不对”，而不只是记录“已经迁过”。这套示例按总量对账、字段逐项比对、用户身份映射核对、附件与链接可用性检查、增量同步复核五层展开，以一次旧研发管理工具迁往ONES的演示情景说明每条规则怎么写、怎么判、结果记在哪里。文中数据为填写示范，不代表真实客户或实测结果。
要点总览（TL;DR）
- 校验规则按五层组织：总量对账、字段逐项比对、用户身份映射核对、附件与链接可用性检查、增量同步复核，先确认整体无缺失，再逐项核对细节。
- 每条规则固定写清校验对象、比对口径、通过标准、抽样方式、责任人和结果记录，判定结论可追溯到具体工作项或账号。
- 字段比对按类别区分口径：必填字段全量查空值，枚举字段核对映射分布，日期字段注意时区跨日，多值字段按集合比对，自由文本抽样查截断与乱码。
- 套用到自身项目时先盘点源数据，以字段映射表为规则输入，按风险分级确定全量与抽样，规则模板与映射表、结果表一起版本化管理。
- 文中规则条目、抽样比例和时间窗口均为演示情景的填写示范，流程与插件迁移、切换验收不在本文校验范围。
这套校验规则要解决什么问题
迁移校验的对象是迁移后的数据内容，具体包括工作项、字段值、用户身份、附件、关联链接，以及迁移窗口内新增或修改的增量数据。校验规则的任务是给出可判定的结论：某个对象在迁移后是否与源端一致、是否可用、是否完整。只记录“已执行迁移脚本”“已导入多少条”属于迁移动作日志，不能替代校验。
这套规则与相邻工作有明确分工。工作流、插件行为、权限配置等系统配置的迁移效果，属于配置迁移与功能验证的范围；是否切换、何时下线旧系统、最终验收签字，属于迁移验证与切换管理。本文只处理数据内容的核对，避免把配置验证和切换决策混进数据校验清单，导致责任人和通过标准说不清。
为了让规则可执行，每条校验条目建议固定写清五项：校验对象、比对口径、通过标准、抽样方式、责任人。校验结果统一记录为可追溯的清单，保留源端标识、目标端标识、比对时间和处理结论，便于迁移后复查和问题回溯。五层框架的作用是给这些条目排定顺序：先确认总量没有整体缺失或重复，再逐字段比对，再核对人员身份，再检查附件与链接是否真的可用，最后对迁移窗口内的变化做二次复核。
完整示例：一次研发项目数据迁移的校验清单
示例情景设定如下：某研发团队将旧研发管理工具中的一个研发项目迁往ONES，迁移范围包括该项目的工作项及其字段值、相关用户与负责人、工作项附件、工作项之间的关联链接，以及迁移执行窗口内产生的新增和修改。以下规则条目为填写示范，数量、比例和时间窗口均按示例设定，实际项目应替换为自身盘点结果。
第一层：总量对账
| 规则编号 | 校验对象 | 比对口径 | 通过标准 | 抽样方式 | 责任人 | 结果记录 |
|---|---|---|---|---|---|---|
| R1-01 | 工作项总数 | 源端导出条数与目标端导入条数按项目比对 | 两边总数一致，差值为0 | 全量计数 | 迁移执行人 | 源端数、目标端数、差值、结论 |
| R1-02 | 工作项类型分布 | 按需求、任务、缺陷等类型分别计数 | 各类型数量与源端一致 | 全量计数 | 迁移执行人 | 各类型源端数、目标端数、差异类型 |
| R1-03 | 状态分布 | 按状态分组计数，含已关闭与进行中 | 各状态数量一致，无异常集中丢失 | 全量计数 | 项目管理员 | 状态对照表、差异说明 |
第二层：字段逐项比对
| 规则编号 | 字段类别 | 比对口径 | 通过标准 | 抽样方式 | 责任人 | 结果记录 |
|---|---|---|---|---|---|---|
| R2-01 | 必填字段（标题、类型、状态） | 逐条比对源端与目标端值 | 空值数为0，值与映射表一致 | 全量 | 迁移执行人 | 异常工作项清单及原因 |
| R2-02 | 枚举字段（优先级、严重程度） | 按字段映射表核对枚举值对应关系 | 无未映射值，无落到默认值的条目 | 全量比对枚举分布 | 迁移执行人 | 枚举映射对照表、未映射值清单 |
| R2-03 | 日期字段（创建时间、截止日期） | 比对日期值与格式，注意时区口径 | 日期一致，无因时区偏移产生的跨日错误 | 全量比对，重点抽查边界日期 | 迁移执行人 | 日期差异清单 |
| R2-04 | 多值字段（标签、模块、参与人） | 比对值的集合，不比较顺序 | 集合内容一致，无重复、无丢失 | 全量比对集合，抽查20条明细 | 项目管理员 | 集合差异清单 |
| R2-05 | 自由文本字段（描述、备注） | 比对文本是否完整，重点看截断与乱码 | 无截断、无乱码，关键段落完整 | 按10%抽样，长文本优先 | 项目管理员 | 抽样记录与问题条目 |
第三层：用户身份映射核对
| 规则编号 | 校验对象 | 比对口径 | 通过标准 | 抽样方式 | 责任人 | 结果记录 |
|---|---|---|---|---|---|---|
| R3-01 | 负责人与经办人 | 按用户映射表核对源端账号与目标端账号 | 全部工作项负责人可对应到有效账号 | 全量 | 系统管理员 | 映射表、未匹配账号清单 |
| R3-02 | 重名账号 | 结合账号、邮箱或工号区分同名用户 | 重名用户各自对应正确，无错配 | 全量核对重名清单 | 系统管理员 | 重名处理记录 |
| R3-03 | 离职与外部账号 | 确认源端离职人员、外部协作账号的归属处理方式 | 每条均有明确归属或标注，无悬空负责人 | 全量 | 项目管理员 | 特殊账号处理清单 |
第四层：附件与链接可用性检查
| 规则编号 | 校验对象 | 比对口径 | 通过标准 | 抽样方式 | 责任人 | 结果记录 |
|---|---|---|---|---|---|---|
| R4-01 | 附件数量 | 按工作项比对附件条数 | 数量一致，无缺失附件 | 全量计数 | 迁移执行人 | 附件数量对照表 |
| R4-02 | 附件可访问性 | 实际打开附件，确认可下载、可预览、内容完整 | 抽样附件全部可正常打开 | 按10%抽样，大文件与特殊格式优先 | 项目管理员 | 抽样打开记录与异常清单 |
| R4-03 | 工作项关联链接 | 检查关联关系是否保留，链接是否指向正确目标 | 关联关系数量一致，抽查链接均可跳转 | 全量比对关联数，抽查20条跳转 | 迁移执行人 | 关联关系对照表、失效链接清单 |
| R4-04 | 正文内引用链接 | 检查描述或评论中引用的工作项、页面链接是否仍可定位 | 抽样链接可定位到对应对象 | 按10%抽样 | 项目管理员 | 引用链接检查记录 |
第五层：增量同步复核
| 规则编号 | 校验对象 | 比对口径 | 通过标准 | 抽样方式 | 责任人 | 结果记录 |
|---|---|---|---|---|---|---|
| R5-01 | 迁移窗口内新增工作项 | 以切换前冻结时间为界，比对窗口内新增条目 | 新增条目全部出现在目标端 | 全量 | 迁移执行人 | 新增条目清单与核对结论 |
| R5-02 | 迁移窗口内修改内容 | 比对窗口内被修改字段的最终值 | 最终值与源端一致，无旧值覆盖 | 全量比对修改记录 | 项目管理员 | 修改记录对照表 |
| R5-03 | 增量复核时点 | 在增量同步完成后、切换确认前执行 | 复核记录时间晚于最后一次同步时间 | 不适用 | 迁移负责人 | 复核时间与同步时间记录 |
校验结果记录表样式
每条规则执行后，在一张汇总表中登记结果，字段建议为：规则编号、校验对象、执行时间、执行人、样本量、异常数、异常说明、处理状态、复核人。处理状态可填“通过”“带问题通过”“待修复”“已复验”。异常条目需关联到具体工作项或账号标识，便于回到目标系统定位。这张表就是迁移交付物的一部分，与字段映射表一起归档。
逐项解释：每条规则为什么这样写
总量对账放在第一层，是因为它成本低、发现问题的范围大。按工作项类型和状态拆分计数，可以区分“整体少了一批”和“某一类集中丢失”两种不同原因。如果只对总数，类型之间的错位可能被总数抵消而看不出来。总量对账不涉及字段细节，适合在迁移刚完成时先跑一遍，尽早决定是否需要重新导入。
字段比对要分类处理，原因是不同字段的失败方式不同。必填字段出问题通常表现为空值，适合全量检查；枚举字段的风险在映射关系，未映射的值可能被静默落到默认值，因此要核对枚举分布而不是只看有没有值；日期字段容易在时区换算上出现跨日偏差，边界日期要重点抽查；多值字段应按集合比对，顺序变化不算错误；自由文本难以逐字全量比对，按比例抽样并优先检查长文本，能覆盖截断和乱码这两类高频问题。
用户身份映射单独成层，是因为它同时影响数据归属和后续协作。重名用户在按姓名匹配时容易错配，需要结合账号、邮箱或工号确认；离职账号和外部协作账号在目标端可能没有对应账号，处理方式要事先约定，例如统一转给项目负责人或保留标注，不能留成悬空负责人。这一层核对完成后，工作项的责任归属才可信。
附件与链接检查可访问性而非只数数量，是因为“存在但打不开”在数量核对中看不出来。附件要实际打开，确认可下载、可预览、内容完整；关联链接要确认指向正确对象，正文中的引用链接也要抽查，避免出现指向旧系统地址的失效链接。抽样时优先覆盖大文件和特殊格式，这类对象在迁移中最容易出问题。
增量复核的关键是时间窗口。以切换前冻结时间为界，窗口内新增的条目要全量确认已进入目标端，窗口内修改的字段要确认最终值没有被旧值覆盖。复核时点必须晚于最后一次同步，否则复核结论不成立。通过标准和抽样比例没有通用阈值，示例中的10%、20条属于填写示范，实际应按数据量、字段重要性和可接受的风险确定；核心字段适合全量，辅助字段可以抽样。
在ONES承载这类校验时，工作项、字段值、附件、评论和关联关系是迁移后需要逐项确认的数据对象，ONES的Jira迁移方案也以项目、工作项、状态、字段、附件和历史记录为迁移范围，并把数据完整作为迁移目标之一。校验清单本身可以放在ONES的项目或文档中，按规则编号建立检查项，异常条目关联到对应工作项，复验结论回写到同一张表，形成从规则到问题再到复验的记录链。
把示例迁移到自己的项目
套用这套规则的第一步是盘点源数据，而不是先改规则模板。盘点要回答三个问题：有哪些实体类型（工作项、文档页面、用户、附件、关联关系），每类各有多少条，哪些字段是业务上必须准确的。盘点结果决定规则数量：实体类型多，就按类型扩展规则编号；字段多，就在字段层按类别分组，不必为每个字段单列一条。
第二步是把字段映射表作为校验规则的输入。映射表写清源字段、目标字段、类型转换方式和枚举对应关系，字段比对规则直接引用映射表，避免规则和映射两套口径。映射表变更时，相关校验条目同步更新。
第三步是按风险分级确定全量与抽样。可以用下面的判断顺序：影响业务连续性的字段（负责人、状态、标题）全量校验；影响检索和统计的字段（类型、优先级、日期）全量比对分布、抽样看明细；辅助信息（备注、标签）按比例抽样。数据量大时，全量计数加分层抽样通常比均匀抽样更能发现问题。
第四步是把模板变成可维护的资产。规则编号按“层号-序号”固定，新增实体类型时追加编号而不打乱已有条目；每次迁移结束后记录哪些规则发现了问题、哪些规则长期无异常，下一项目据此调整抽样比例。规则模板与字段映射表、校验结果表一起版本化管理，换项目时复制一份再改，不直接改原模板。
示例的适用边界与不覆盖内容
本文的规则条目、数量、抽样比例和时间窗口均为演示情景下的填写示范，用于说明写法，不代表任何真实客户的数据、实测结果或成效。实际项目的通过标准应以源数据盘点结果和迁移方案确认为准。
以下内容不在本文校验范围内，需要另行安排：工作流、插件行为和权限配置的迁移效果验证；迁移后的切换决策、回滚安排与最终验收签字；具体产品的兼容版本、部署方式和认证结论。这些事项涉及配置与决策，判定口径与数据校验不同，混在同一张清单里会削弱各自的责任边界。
此外，数据量级、源系统版本差异、字段类型转换和链接重写的具体机制，都会影响校验细则的颗粒度。示例中的规则可以直接作为起点，执行前仍需与迁移实施方确认实际的转换规则和同步方式，再补充针对性的检查条目。
常见问题
迁移校验时，抽样比例应该怎么定？
抽样比例没有通用阈值，示例中的10%、20条属于填写示范。可按字段对业务的影响分级：负责人、状态、标题这类直接影响业务连续性的字段适合全量校验；类型、优先级、日期这类影响检索和统计的字段可以全量比对分布、抽样看明细；备注、标签等辅助信息按比例抽样即可。数据量大时，全量计数加分层抽样通常比均匀抽样更容易发现问题。比例确定后写进规则条目，并在迁移结束后根据实际发现的问题调整。
源端有离职人员和外部协作账号，负责人映射怎么处理？
这类账号在目标端可能没有对应账号，处理方式要在迁移前约定，例如统一转给项目负责人、保留原姓名标注或归入指定账号。校验时逐条确认每个特殊账号都有明确归属，不出现悬空负责人。重名用户要结合账号、邮箱或工号区分，不能只按姓名匹配。这一层核对完成后，工作项的负责人归属才可信，后续的协作和统计也才有依据。
附件数量对上了，为什么还要逐个打开检查？
数量一致只能说明附件条目都在，无法反映“存在但打不开”的情况。附件迁移后可能出现下载失败、预览异常或内容截断，这些问题在计数比对中看不出来。校验时要实际打开抽样附件，确认可下载、可预览、内容完整，抽样优先覆盖大文件和特殊格式。关联链接同理，除了比对关联数量，还要抽查链接是否指向正确对象，正文中引用的链接也要检查是否仍能定位。
增量同步复核应该在什么时点做？
复核时点必须晚于最后一次增量同步，否则复核结论不成立。通常以切换前冻结时间为界，窗口内新增的工作项要全量确认已进入目标端，窗口内被修改的字段要确认最终值没有被旧值覆盖。复核记录中保留同步时间和复核时间，两者先后关系清晰可查。如果同步和复核之间又产生了新的修改，需要重新执行一轮增量同步并再次复核。
这套校验清单能直接用于工作流和插件迁移的验证吗？
不能直接套用。本文规则针对的是数据内容，包括工作项、字段值、用户身份、附件、链接和增量数据。工作流、插件行为和权限配置的迁移效果属于配置迁移与功能验证的范围，判定口径不同；是否切换、何时下线旧系统、最终验收签字属于迁移验证与切换管理。把配置验证混进数据校验清单，会让责任人和通过标准变得模糊，建议分开编制清单。
