验证Jira数据迁移完整性，核心是把“完整”拆成可核验的对象与字段：工作项数量、字段值、状态与流转历史、附件、评论、用户与权限映射、关联关系。再对每个对象确定源端与目标端的同口径统计方式，用总量对账、抽样逐字段比对和关键业务场景回放三层证据交叉验证。判定通过需要预设容差与例外清单，分母为零、字段不可比和时区差异要单独说明，单看总量一致不能证明迁移完整。
要点总览（TL;DR）
- 验证Jira数据迁移完整性，先把“完整”拆成工作项数量、字段值、状态与流转历史、附件、评论、用户与权限映射、关联关系等可核验对象，再逐项确定源端与目标端的同口径统计方式。
- 每个指标要写清分子、分母、时间窗和单位，并按项目、问题类型、创建年份分层统计，避免总量一致掩盖某一类对象的整类缺失。
- 对账前先完成口径对齐：状态、优先级、问题类型的枚举映射，时区与日期精度差异，富文本与附件的存储差异，以及已删除、归档、私有项目的处理约定。
- 验证采用三层交叉证据：总量对账发现差多少，分层抽样逐字段比对发现哪里不对，关键业务场景回放确认迁移后业务可用；单看总量一致不能判定通过。
- 判定通过需预设容差与例外清单，分母为零和不可比字段单独说明；关键字段未登记缺失、整类对象差异未定位原因、阻断级差异未复验，均不能算通过。
完整性验收要回答哪几个问题
验收开始前，先把“迁移完整”翻译成一份可判定的目标说明。这份说明至少回答三个问题：本次迁移覆盖哪些项目和对象，完整性按哪几个层级判定，谁在什么条件下签字确认。缺少这份说明，后续对账数字再精确，也无法形成可交付的验收结论。
迁移范围要写成清单，并明确列出不在范围内的对象。常见范围项包括：参与迁移的项目键、问题类型、时间区间、附件与评论是否随工作项迁移、用户与用户组、权限方案、自定义字段、工作流与状态、关联链接与子任务关系。不在范围内的对象也要点名，例如已归档项目、测试项目、历史遗留的孤立附件、第三方插件写入的扩展数据。范围清单的作用是确定分母：哪些数据应当出现在目标端，哪些数据不参与本次完整性判定。
完整性判定建议分四个层级，逐层加严：
- 数量层：对象条数在源端与目标端一致，或在预设容差内。
- 字段层：关键字段的值逐条可比，枚举值完成映射，日期与文本内容可核对。
- 关系层：父子任务、关联链接、评论与附件的归属关系保持正确。
- 历史层：状态流转记录、变更历史、评论时间顺序在目标端可追溯。
通过条件要写成可执行的判定语句，例如“数量层全部对象差异为零或已登记例外；字段层抽样差异率不超过约定阈值且无高风险字段丢失；关系层与历史层的关键场景回放全部通过”。签字确认通常由业务负责人确认范围与业务可用性，由迁移执行人确认对账与差异记录，由系统负责人确认权限与配置。三方确认的对象是同一份验收目标说明和差异清单，避免各自按不同口径判断。
指标与统计范围怎么划
指标要能复算，就必须同时写清分子、分母、时间窗和单位。只写“工作项迁移率99%”无法复验，因为读者不知道分母是否包含已删除工作项、是否按创建时间还是更新时间截取。下表给出一组可直接套用的指标定义，实际使用时按项目替换统计范围。
| 指标名 | 分子 | 分母 | 时间窗 | 单位 |
|---|---|---|---|---|
| 工作项数量完整率 | 目标端存在的、属于迁移范围的工作项数 | 源端按同一过滤条件导出的工作项数 | 以迁移冻结时点为准 | 条、百分比 |
| 评论迁移完整率 | 目标端可查到且归属正确的工作项评论数 | 源端范围内工作项的评论总数 | 与工作项同一冻结时点 | 条、百分比 |
| 附件迁移完整率 | 目标端可下载且文件大小、文件名匹配的附件数 | 源端范围内工作项的附件总数 | 与工作项同一冻结时点 | 个、百分比 |
| 用户映射覆盖率 | 目标端已建立账号或映射关系的源端活跃用户数 | 源端在范围内有操作记录的活跃用户数 | 迁移前一个完整统计周期 | 人、百分比 |
| 关联关系保留率 | 目标端两端工作项均存在且链接类型正确的关联数 | 源端范围内工作项之间的关联链接总数 | 与工作项同一冻结时点 | 条、百分比 |
分层统计是必要动作。按项目、问题类型、创建年份分层后，总量一致但某一问题类型全部缺失的情况才能暴露。建议至少按“项目×问题类型”出一张交叉表，再按创建年份看分布。分层后某些格子分母为零，例如某项目没有附件，这类格子标注“不适用”，不并入总体完整率计算，也不记为差异。
时间窗要统一到迁移冻结时点。迁移期间源端仍在产生新数据时，源端计数会持续变化，对账结果无法复现。可行做法是先冻结写入或确定一个截止时间，两端都按该时点导出，并在报告中写明冻结时间与导出时间。
源端与目标端的数据口径怎么对齐
两端数字对不上，很多时候不是数据丢了，而是取数口径不同。对齐口径的工作要在对账之前完成，产出一份字段映射与口径对照表，逐项写明源端字段、目标端字段、转换规则和例外说明。
枚举映射是最常见的一类。Jira的状态、优先级、问题类型、解决结果在目标端往往有不同命名和数量。映射表要覆盖全部取值，包括低频状态和自定义状态，并标注哪些源端值在目标端合并、拆分或需要新建。合并会让数量对账出现“目标端某状态变多”，这属于预期差异，应写入例外说明而不是当作丢失。
存储与格式差异同样影响比对。时区设置不同会让同一时间戳显示为不同日期，日期精度从秒级变为天级会让排序和区间统计出现偏差。富文本在转换后可能丢失部分样式，附件可能被重命名或改变存储路径。比对时应区分“内容等价”和“字节一致”：评论正文比对文本内容，附件比对文件名、大小和可下载性，不要求二进制完全一致，除非业务有明确要求。
已删除、归档和私有项目的处理要提前约定。已删除工作项通常不进入迁移范围，但源端报表可能仍统计到它们；归档项目可能整体不迁移；私有项目的权限结构在目标端可能无法一一对应。这些对象要么明确排除并写入范围清单，要么单独统计并单列差异，不能混入总体分母后不作说明。
三层验证步骤：总量对账、抽样比对、场景回放
三层验证的作用不同，不能互相替代。总量对账发现“少了多少”，抽样比对发现“哪里不对”，场景回放发现“业务上能不能用”。三层都完成，证据才形成闭环。
第一层，总量对账。两端按同一过滤条件导出计数，逐项比对工作项、评论、附件、用户、关联链接。执行时先锁定冻结时点，再分别导出，导出条件写成可复现的过滤语句并附在报告里。通过标准是：范围内对象差异为零，或差异全部落入已登记的例外清单。出现差异时，先按项目、问题类型、创建年份下钻定位，再判断是口径问题还是真实缺失。
第二层，抽样比对。采用分层抽样，层可以按问题类型、创建年份、是否有附件、是否有长评论历史划分。高风险对象应提高抽样比例或全量核对，例如状态流转次数多的工作项、附件多的工作项、跨项目关联多的工作项。逐字段核对时记录差异类型：字段缺失、值被截断、枚举映射错误、时间偏移、附件不可下载、评论归属错误。通过标准按差异类型分别设定，关键字段不允许出现未登记差异。
第三层，场景回放。选取典型工作项，在目标端完整走一遍业务动作：打开工作项查看字段与历史，查看评论与附件，沿关联链接跳转到另一端，按状态流转规则推进一次状态，确认权限不同的用户看到的内容符合预期。场景回放验证的是迁移后的可用性，数量与字段都对但流程走不通，同样不能算通过。
差异分级与容差要在执行前定好。建议分为三级：阻断级，关键字段或整类对象缺失，必须修复后复验；一般级，非关键字段格式差异，登记后可接受；说明级，口径差异或预期合并，写入例外清单。容差只适用于可解释的非关键差异，不能用来掩盖整类对象缺失。
一个可复算的验证示例
以下为演示情景，数字用于说明计算过程，不代表任何真实项目。假设某次迁移范围为项目DEMO，冻结时点源端导出工作项1200条、评论8600条、附件430个、活跃用户85人、关联链接310条。
目标端对账结果：工作项1196条，评论8572条，附件430个，用户映射83人，关联链接302条。逐项计算完整率，公式为“目标端数量÷源端数量×100%”：
- 工作项完整率：1196÷1200＝99.67%，差异4条。
- 评论完整率：8572÷8600＝99.67%，差异28条。
- 附件完整率：430÷430＝100%。
- 用户映射覆盖率：83÷85＝97.65%，差异2人。
- 关联关系保留率：302÷310＝97.42%，差异8条。
差异处理示例：4条工作项经核查属于源端已删除但报表仍计入的记录，属于口径差异，登记为例外；28条评论中有26条归属到合并后的重复工作项，2条因原工作项被排除在范围外，前者需确认合并规则，后者补入例外清单；2名用户为离职账号，确认无需映射；8条关联链接中有5条指向范围外项目，3条需修复后复验。按此处理，需修复项为3条关联链接和26条评论的归属确认。
分母为零的情形单独说明：若某问题类型在源端没有附件，该格子的附件完整率记为“不适用”，不参与总体附件完整率的分母，也不计为0%。不可比字段同样单列，例如源端某自定义字段在目标端没有对应字段，应在映射表中标注“不迁移”，并在报告中说明该字段不纳入字段层判定。
结果怎么解读，哪些情况不能算通过
完整性指标回答的是“按约定口径，数据是否到位”，不能直接等同于迁移质量全部合格。解读时要守住几条边界。
数量一致但字段丢失，是最常见的误判。工作项条数完全对上，但描述被截断、自定义字段为空、状态历史只剩当前状态，这类问题在总量对账中不可见，只能靠抽样比对和场景回放发现。因此数量层通过不能单独作为验收结论。
抽样未覆盖高风险对象，会让结论偏乐观。如果抽样集中在近期、结构简单的工作项，历史长、附件多、跨项目关联多的工作项恰好是问题高发区。抽样方案要写明分层依据和高风险对象的覆盖情况，未覆盖的部分在报告中列为局限。
单指标不能代表整体迁移质量。工作项完整率99%不能推出评论、附件、权限同样完整，各对象要分别给出结果。把多个指标简单平均也会掩盖阻断级问题，建议按层级分别判定，任一关键层级存在未登记差异即不通过。
以下情形不能判定通过：关键字段存在未登记缺失；整类对象数量差异未定位原因；权限映射导致部分用户看不到应有数据；状态流转在目标端无法按规则推进；差异清单中的阻断级项未修复复验。遗留差异要逐条登记责任人与复验时间，复验通过后才从清单中关闭。
在迁移执行与验收的管理动作上，ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，问题数据包括属性值、附件和评论，用户、用户组及问题类型、工作流、字段配置、权限配置等系统配置也在迁移范围内。这些对象正好对应前文的验收清单：迁移范围确定后，可按对象逐项建立对账口径；差异登记与复验可以依托工作项和文档状态流转来跟踪，让每条遗留差异有负责人和关闭条件。对于定制插件等场景，ONES建议迁移前逐项评估，这类评估结论也应进入范围清单和例外说明，避免验收时才发现功能无法一一对应。
常见问题
迁移期间源端还在产生新数据，对账数字一直对不上怎么办？
先确定一个迁移冻结时点，两端都按该时点导出数据，并在报告中写明冻结时间与导出时间。可行做法是冻结源端写入，或约定一个截止时间后不再变更统计范围。如果无法完全冻结，就把冻结后新增的数据单独统计、单独说明，不并入本次完整性判定的分母，否则对账结果无法复现。
某个问题类型在源端没有附件，附件完整率应该记0%还是不计入？
记为“不适用”，不并入总体附件完整率的分母，也不计为0%。分母为零的格子如果按0%处理，会人为拉低整体指标，掩盖其他对象的问题。报告中应把这类格子单独列出，说明该问题类型在源端确实没有附件，属于统计范围的自然空缺，不是迁移差异。
总量对账全部一致，是否就可以签字验收？
不能。总量一致只能说明对象条数到位，字段被截断、自定义字段为空、状态历史只剩当前状态这类问题在总量对账中不可见。需要继续完成分层抽样逐字段比对和关键业务场景回放，三层证据都通过，且差异清单中的阻断级项已修复复验，才具备签字条件。
源端某自定义字段在目标端没有对应字段，完整性怎么算？
在字段映射与口径对照表中标注“不迁移”，并在报告中说明该字段不纳入字段层判定。这类字段属于不可比字段，不能计入缺失，也不能算作完整。如果该字段承载业务关键信息，应在迁移前评估是否需要在目标端新建对应字段，评估结论写入范围清单，避免验收阶段才发现信息无法承接。
遗留差异登记后，复验应该关注什么？
每条遗留差异登记责任人、差异类型、影响范围和复验时间。复验时先确认原差异是否已消除，再检查修复动作是否引入新的关联问题，例如修复关联链接后两端工作项是否仍然存在、链接类型是否正确。阻断级差异修复后必须复验通过才能从清单关闭，一般级和说明级差异可按约定周期抽查。
