验证Jira数据迁移完整性，需要把“完整”拆成对象数量、字段内容、关联关系、附件与历史记录四类，用同一时间窗和同一筛选条件在源端与目标端分别取数，按“一致数÷应迁数”计算一致率，并对差异逐条归因。本文给出一套可复算的口径、公式和验收步骤，帮助研发管理者和项目管理员判断迁移是否达到切换条件。
要点总览（TL;DR）
- 完整性验证拆成对象数量、字段内容、关联关系、附件与历史四类，每类给出可判断的通过表述，避免用“看起来差不多”代替验收。
- 分母定义为源端在迁移冻结时点的应迁记录数，分子为目标端同口径可对应记录数；冻结后源端变更单独记录，不混入一致率计算。
- 核心公式：总量一致率＝同口径一致数÷源端应迁数×100%，字段一致率＝抽样一致条数÷抽样记录数×100%，关系匹配率按史诗、子任务、版本、冲刺、用户五类关联分别统计。
- 两端取数使用等价筛选条件，留存导出文件、查询语句、执行时间和执行人，并以字段映射表记录未映射与转换规则。
- 高一致率不等于业务可用，需结合关键字段全量核对与关键流程抽查；差异未清零时按整改、复验、书面接受处理，阈值结合自身范围确定。
验证目标：完整性要回答哪几个问题
完整性验证的目标是回答“该迁的是否都迁了、迁过去的内容是否一致、对象之间的关联是否保留、附件和历史是否可追溯”。把这四个问题转成可判断的表述，验收才有依据，而不是停留在“看起来差不多”。
四类判断项可以这样定义：
| 类别 | 验证对象 | 可判断的通过表述 |
|---|---|---|
| 对象数量 | 项目、问题、子任务、评论、附件记录 | 目标端同口径记录数与源端应迁记录数一致，差异逐条有归因 |
| 字段内容 | 标题、描述、状态、优先级、经办人、自定义字段 | 抽样记录中关键字段值与源端一致，未映射字段有明确说明 |
| 关联关系 | 问题与史诗、子任务、版本、冲刺、用户的关联 | 关联匹配率达到约定阈值，断链记录可定位、可修复 |
| 附件与历史 | 附件文件、评论、变更历史 | 附件数量一致且可打开，评论与历史记录按时间顺序保留 |
验证时点分三段：迁移前建立基线，记录源端各口径的数量和抽样样本；迁移后做核对，计算一致率并形成差异清单；切换前复核，确认差异已整改或已书面接受。三段各自留痕，后续出现争议时能回溯到具体时点的数据。
指标与范围：分母怎么定、时间窗怎么切
一致率失真的常见原因是分子和分母口径不同。分母应定义为“源端在冻结时点应迁移的记录数”，分子是“目标端在同口径下能对应上的记录数”。两者必须使用相同的项目范围、问题类型、状态集合和字段集。
范围要素需要逐项写清：
- 项目：列出纳入迁移的项目清单，排除的项目单独说明原因。
- 问题类型与状态：明确哪些类型、哪些状态计入应迁范围，已归档或已删除数据是否纳入。
- 字段集：区分关键字段（标题、描述、状态、经办人、优先级等）与一般自定义字段，关键字段全量核对，一般字段抽样核对。
- 附件、评论与变更历史：分别设定是否全量迁移，以及数量核对的口径。
时间窗以迁移冻结时点为准。冻结后源端如果仍有新增或修改，应单独记录为“冻结后变更”，不混入本次一致率计算，否则分子分母都不可比。冻结时点、冻结操作人和冻结范围要写入验证记录。
分母为零的空项目要单独列出，说明不计入一致率计算，避免空项目拉低整体指标，也避免被误当作迁移成功。若某类对象在源端数量为零，目标端出现同类记录，应作为异常差异单独核查。
数据口径与证据：源端和目标端怎么取同一份数
两端取数要使用等价筛选条件。可以用导出报表、API查询或数据库查询，选择哪种方式取决于可访问性和可复核性，关键是两端条件一一对应，例如同一项目键、同一问题类型集合、同一状态过滤、同一时间范围。
每次取数应留存四类证据：导出文件或查询结果、查询语句或筛选条件截图、执行时间、执行人。证据按“源端/目标端＋对象类别＋取数日期”命名归档，便于第三方复算。
字段映射表是比对依据。映射表至少记录：源端字段名、目标端字段名、字段类型、是否迁移、转换规则（如状态映射、优先级映射、用户映射）、未映射字段及原因。字段被截断、枚举值找不到对应项、用户账号无法匹配，都会在映射表中留下记录，这些记录直接决定字段一致率的分母如何计算。
在迁移执行与差异跟踪环节，可以把验证任务本身放进协作工具管理。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，迁移问题数据时包含属性和属性值、附件、评论等信息；验证过程中产生的差异记录、责任人和整改状态，可以借助工作项和报表能力持续跟踪，让每条差异都有归属和结论。
计算与评估步骤：从总量核对到逐字段抽样
验证按“总量—字段—关系—附件与评论”四层推进，每层给出公式和判断方式。
第一层，总量核对。总量一致率＝两端同口径记录数一致数÷源端应迁记录数×100%。分母是冻结时点源端应迁记录数，单位是“条”。按项目、问题类型分别计算，再汇总。差异条数要能对应到具体对象标识，不能只报一个总数。
第二层，字段核对。字段一致率＝抽样记录中字段值一致条数÷抽样记录数×100%。抽样应覆盖不同问题类型、不同状态和关键自定义字段，关键字段建议全量核对，一般字段按约定比例抽样。字段值比较前先按映射表做规范化，例如状态名称映射、用户账号映射，避免因命名差异误判为不一致。
第三层，关系核对。关系匹配率＝关联关系匹配条数÷应迁关联关系条数×100%，分别统计问题与史诗、子任务与父任务、问题与版本、问题与冲刺、问题与经办人五类关联。断链要记录断在哪一端、原因是什么。
第四层，附件与评论。先做数量核对，再做可打开性抽查：附件按文件大小和类型分层抽样，确认可下载、可预览；评论核对数量和顺序，变更历史核对关键状态流转节点是否保留。
差异清单至少包含以下字段，作为整改和复验的载体：
| 字段 | 说明 |
|---|---|
| 对象标识 | 源端问题键或记录ID，便于两端定位 |
| 差异类型 | 缺失、字段值不一致、关联断链、附件缺失、历史缺失 |
| 原因 | 字段截断、映射缺失、权限过滤、附件超限等 |
| 处置结论 | 已修复、接受差异、待复验，并记录责任人与日期 |
例子：一个项目集的完整性核对怎么算
以下为演示数据，仅用于说明计算过程，不代表任何真实迁移结果。
设定范围：两个项目，冻结时点源端应迁问题共2000条，其中项目A 1200条、项目B 800条；关键字段抽样200条；应迁关联关系共1500条；附件记录300条。
总量核对。目标端同口径查到项目A 1196条、项目B 800条，合计1996条与源端对应。总量一致率＝1996÷2000×100%＝99.8%。差异4条均在项目A，差异清单记录为“缺失”，待查原因。
字段核对。抽样200条，逐字段比对后，字段值完全一致的记录为188条。字段一致率＝188÷200×100%＝94%。不一致的12条中，7条为描述字段被截断，3条为状态映射缺失（源端自定义状态在目标端无对应项），2条为经办人账号未匹配。
关系核对。应迁关联关系1500条，目标端匹配1461条。关系匹配率＝1461÷1500×100%＝97.4%。断链39条中，多数集中在已关闭冲刺的关联上，需确认目标端是否保留历史冲刺。
附件与评论。附件记录300条，目标端298条，数量一致率约99.3%；抽查50个附件，48个可正常打开，2个因源端文件本身损坏无法打开，记录为源端问题。评论数量两端一致。
结论推导。总量一致率99.8%但存在4条缺失，字段一致率94%低于预期，关系匹配率97.4%且有集中断链。此时不宜直接判定通过，应先把4条缺失、7条截断、3条状态映射缺失列入整改，修复后对同一范围复验；对源端损坏附件和无法映射的自定义状态，形成书面接受记录。复验后各层一致率达到约定阈值且差异清单无“待复验”项，才进入切换前复核。
解读与限制：哪些数字不能直接当结论
一致率高不等于业务可用。总量一致率接近100%时，仍可能存在关键字段丢失或关键流程断链，因此要结合关键字段全量核对和关键流程抽查，例如一条完整的需求到缺陷流转链路能否在目标端走通。
数据不可比的情况要单独识别：源端在迁移窗口内继续变更、字段映射规则在中途调整、目标端在核对期间又发生写入，都会让两端数字失去可比性。遇到这类情况，应重新冻结或重新取数，而不是在旧数据上反复计算。
抽样覆盖不足时，字段一致率只适用于抽样范围，不能外推为全部记录的结论。抽样比例、分层方式和抽样人应写入验证记录，必要时扩大样本复算。
差异未清零时，按“整改—复验—结论”处理：每条差异明确责任人和期限，修复后对同一对象标识复验，复验通过后更新差异清单状态。对确认无法修复或业务上可接受的差异，形成书面接受记录并说明影响范围。只有差异清单中不再有“待复验”项，且各层一致率达到企业事先约定的阈值，才具备切换条件；阈值应结合自身数据范围和关键字段确定，不宜套用统一标准。
常见问题
迁移冻结后源端Jira还有新提交的问题，这部分要不要计入完整性一致率？
不计入本次一致率计算，单独记录为“冻结后变更”。冻结时点一旦确定，源端应迁记录数就固定下来，冻结后新增或修改的数据如果混入分子分母，两端数字会失去可比性。处理方式是在验证记录中写明冻结时点、冻结操作人和冻结范围，把冻结后变更另列清单，在切换前复核阶段单独确认这些数据是否需要补迁或增量同步。
字段一致率抽样多少条才够，抽样结果能不能代表全部记录？
抽样比例没有统一标准，取决于记录总量、字段差异风险和可投入的核对人力。抽样应覆盖不同问题类型、不同状态和关键自定义字段，关键字段建议全量核对，一般字段按约定比例分层抽样。抽样得出的字段一致率只适用于抽样范围，不能直接外推为全部记录的结论；抽样比例、分层方式和抽样人应写入验证记录，发现集中性差异时扩大样本复算。
自定义状态在目标端找不到对应项，这类差异怎么处置？
先在字段映射表中登记该状态为“未映射”，写明源端状态名、目标端候选值和缺失原因，再判断影响范围：如果涉及关键流程节点，应在迁移配置中补充映射或调整目标端状态方案后重新迁移该部分数据；如果属于低频状态且业务上可接受，形成书面接受记录并说明影响范围。无论哪种处置，都要在差异清单中保留对象标识和结论，复验时逐条核对。
附件数量对上了，但部分文件打不开，算不算完整性通过？
数量一致只说明记录层面迁移完成，可打开性抽查是另一层判断。抽查发现无法打开的文件，要先区分原因：源端文件本身损坏的，记录为源端问题并书面接受；迁移过程中损坏或丢失的，列入整改并重新迁移。附件按文件大小和类型分层抽样，确认可下载、可预览，抽查结果和处置结论一并写入差异清单。
各层一致率达到多少才算迁移通过？
没有通用的达标线，阈值应结合企业自身的数据范围、关键字段重要性和业务连续性要求事先约定。判断通过通常需要同时满足两个条件：各层一致率达到约定阈值，且差异清单中不再有“待复验”项。总量一致率接近100%但存在关键字段丢失或关键流程断链时，仍不宜判定通过，应完成整改复验后再进入切换前复核。
