核对Jira迁移后的数据完整性，核心是先把核对对象和口径定下来，再对来源端与目标端分别取数，逐项比对总量、字段值和关联关系，最后按事先约定的标准判定并记录差异。本文给出一套可复算的核对方法，包括核对目标、指标公式、取数口径、比对步骤、算例和判定限制，适合负责迁移验收的研发管理者或项目管理员使用。
要点总览（TL;DR）
- 核对Jira迁移完整性，先定对象再定口径：项目、问题、字段、附件、评论、状态历史、用户与权限，每类对象分别给出结论。
- 指标要可复算，写清分子、分母、时间窗和单位，例如记录数完整率=目标端记录数÷来源端记录数×100%，分母为零的对象单独标注、不参与汇总。
- 核对顺序按总量、字段、关联、差异归因四步推进，先缩小范围再逐条核查，差异分为迁移遗漏、转换规则差异和统计口径差异。
- 通过标准按对象类型分别设定允许差异阈值，区分阻断性差异与可接受差异；完整性达标只说明数据按约定迁移到位，不能推断业务效果。
- 两端取数要在同一时间点、同一过滤条件下完成，并留存导出文件、查询条件、字段映射表和差异清单，结论才可复核。
核对目标：完整性要回答哪几个问题
“数据是否完整”是一个笼统的说法，落到验收上需要拆成若干可以逐项回答的问题。建议在迁移开始前就把这些问题写成核对目标清单，迁移后按清单逐条给出结论，避免验收时临时决定查什么。
核对对象通常包括六类：项目本身（项目名称、标识、负责人等）、问题（数量、类型、关键字段值）、附件、评论、状态与流转历史、用户与权限。每一类对象对应不同的核对意图，判定方式也不同。
| 核对对象 | 核对意图 | 判定方式 |
|---|---|---|
| 项目 | 约定的项目是否全部建立，项目属性是否一致 | 项目清单逐项对照，缺失即为差异 |
| 问题 | 问题数量与关键字段值是否按约定迁移到位 | 总量比对加字段值抽样或全量比对 |
| 附件 | 附件是否挂接到对应问题且可正常打开 | 附件数量比对加可下载抽检 |
| 评论 | 评论是否保留、是否挂在正确的问题下 | 评论数量比对加内容抽检 |
| 状态与流转历史 | 当前状态是否正确，历史流转记录是否保留 | 状态分布比对加历史记录抽检 |
| 用户与权限 | 用户、用户组及项目权限是否按约定迁移 | 用户与权限清单逐项对照 |
从判定角度看，完整性可以分成三类目标。数量完整指记录条数一致，例如来源端某项目有1200个问题，目标端也应有1200个。字段值完整指关键字段的内容一致，例如问题标题、负责人、优先级、截止日期在两端相同。关联关系完整指对象之间的挂接关系保留，例如子任务仍挂在父任务下、附件仍属于原问题、评论仍出现在原问题的时间线上。三类目标要分别核对，只比总数会掩盖字段丢失，只查字段又可能漏掉整条记录缺失。
需要明确的是，核对结论只针对迁移方案中约定的范围。方案约定迁移问题、附件和评论，核对结论就只说明这些对象是否到位；方案未纳入的历史数据、插件数据或已归档项目，不在结论覆盖范围内。完整性达标说明数据按约定迁移到位，不能据此推断团队效率、交付质量等业务效果发生了变化。
指标与范围：用哪些指标、覆盖多大范围
完整性核对要能被第三方复算，每个指标都必须写清分子、分母、时间窗和单位。下面四个指标覆盖了数量、字段、附件和关联四类问题，可以作为基础指标集，再按项目实际情况增补。
| 指标 | 公式 | 分母口径 | 时间窗与单位 |
|---|---|---|---|
| 记录数完整率 | 目标端记录数 ÷ 来源端记录数 × 100% | 来源端在约定范围内的问题（或其他对象）总数 | 取数截止到迁移冻结时点；单位：条、% |
| 字段非空一致率 | 两端字段值一致且非空的记录数 ÷ 来源端该字段非空记录数 × 100% | 来源端该字段有值的记录数，不含来源端本身为空的记录 | 按字段分别计算；单位：条、% |
| 附件可下载率 | 目标端可正常下载的附件数 ÷ 来源端附件总数 × 100% | 来源端在约定范围内的附件总数 | 抽检或全量；单位：个、% |
| 关联关系保留率 | 目标端挂接关系正确的记录数 ÷ 来源端存在该关联的记录数 × 100% | 来源端存在子任务、链接、评论等关联的记录数 | 按关联类型分别计算；单位：条、% |
分母口径是最容易出问题的地方。以字段非空一致率为例，如果分母用来源端全部记录数，来源端本身为空的字段会被算成“不一致”，指标会偏低；如果分母只用来源端非空记录数，则衡量的是“有值的数据是否迁对”，与“字段是否该有值”是两个问题。两种口径都可以用，但必须在指标定义里写清楚，并且两端使用同一口径。
范围界定要回答三个问题：按哪些项目核对、覆盖哪个时间区间、全量还是抽样。项目数量少、问题量可控时建议全量核对；问题量很大时可以对字段值和评论内容抽样，但总量指标仍应全量比对。抽样要说明抽样方法和样本量，例如按问题类型分层、每层随机抽取不少于30条，或按问题总量的固定比例抽取。抽样结论只代表样本覆盖的范围，写结论时要注明“抽检”而非“全量核对”。
数据口径与证据：来源端和目标端怎么取数
两端取数口径不一致，是产生虚假差异的主要原因。取数前先约定三件事：取数方式、取数时间点和字段映射关系。
取数方式上，来源端和目标端都可以通过导出、查询或接口获取数据，关键是两端使用同一种粒度和同一种过滤条件。例如来源端按“项目=某项目、创建时间在2023-01-01至2024-06-30之间”导出问题清单，目标端就要用等价条件导出，而不是导出全部问题再人工筛选。取数时间点要记录到具体日期和时刻，最好在迁移冻结后、业务恢复写入前完成两端取数，避免目标端在核对期间新增数据导致数量对不上。
字段映射是核对字段值的前提。迁移前应形成字段映射对照表，写明来源字段、目标字段、转换规则。常见转换包括：状态名称按映射表转换、优先级枚举值重新对应、用户账号按人员映射表替换、富文本字段的格式转换。核对时按映射表判断“一致”，而不是按字面完全相同判断。
| 来源字段 | 目标字段 | 转换规则 | 核对方式 |
|---|---|---|---|
| 问题标题 | 工作项标题 | 原样迁移 | 逐条比对 |
| 状态 | 工作项状态 | 按状态映射表转换 | 按映射表比对 |
| 经办人 | 负责人 | 按人员映射表替换账号 | 按映射表比对 |
| 描述 | 描述 | 富文本格式转换 | 抽检内容要点 |
证据留存要覆盖核对全过程：两端导出文件或查询结果、使用的查询语句或筛选条件、字段映射对照表、比对结果和差异清单。缺失值和空值要提前约定处理方式，例如来源端为空的字段不计入字段一致率的分母，目标端多出的空值单独列为差异项。这些约定写进取数口径说明，核对结论才有可复核的基础。
在ONES承接迁移的场景中，其Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，并迁移用户、用户组及问题类型、工作流、字段配置、权限配置等系统配置，问题数据包括属性和属性值、附件、评论等信息。核对时可以把上述对象清单作为取数范围的起点，按实际迁移方案逐项确认后再取数。核对过程中形成的差异清单和结论记录，可以在ONES的项目或知识库中留档，便于后续复核。
核对步骤：从总量到明细逐层比对
核对顺序建议先粗后细：先用总量比对确认范围，再用字段比对定位内容问题，然后检查关联关系，最后对差异逐条归因。这样可以在问题量大时快速缩小排查范围。
第一步，总量比对。按项目、问题类型、时间区间分别统计来源端和目标端的记录数，与指标定义中的记录数完整率对应。总量不一致时，先检查两端过滤条件是否等价，排除口径问题后再判断是否为迁移遗漏。
第二步，字段比对。对关键字段逐项对照，统计不一致条数并计算字段非空一致率。建议按字段分别出结果，而不是合并成一个总分，因为不同字段的差异原因和严重程度不同。比对时以字段映射表为准，转换规则内的差异不算不一致。
第三步，关联比对。检查子任务与父任务的挂接、问题链接、附件归属、评论归属以及状态历史记录。关联关系出错往往不影响总量，但会直接影响使用，例如附件挂错问题、评论丢失作者信息。
第四步，差异归因。把每条差异归入三类之一：迁移遗漏（来源端有、目标端没有）、转换规则差异（按映射表应转换但结果不符）、统计口径差异（两端取数条件不等价造成的假差异）。归因结果记入差异清单，作为修复和复检的依据。
| 差异编号 | 对象 | 差异描述 | 归因类别 | 处理方式 | 复检结果 |
|---|---|---|---|---|---|
| D-001 | 问题 | 目标端缺少3条记录 | 迁移遗漏 | 补迁后复检 | 待复检 |
| D-002 | 状态 | 5条记录状态与映射表不符 | 转换规则差异 | 按映射表修正 | 待复检 |
算例：一个项目的完整性核对怎么算
以下为演示情景，数字仅用于说明计算方法。
某项目在来源端有1200个问题、860个附件、3400条评论；目标端迁移后有1197个问题、860个附件、3388条评论。取数时间点均为迁移冻结后当日，范围为该项目全部问题，全量核对。
记录数完整率 = 1197 ÷ 1200 × 100% = 99.75%，差异3条，归因为迁移遗漏，需补迁后复检。附件可下载率按全量核对，860个附件均可正常下载，860 ÷ 860 × 100% = 100%。评论保留率 = 3388 ÷ 3400 × 100% ≈ 99.65%，差异12条，需逐条确认是遗漏还是归属错误。
字段层面，假设来源端“负责人”字段非空记录为1150条，目标端与来源端按人员映射表比对一致的为1142条，则字段非空一致率 = 1142 ÷ 1150 × 100% ≈ 99.30%，不一致8条需按映射表逐条核查。
分母为零的情形要单独处理。假设同批次另一个项目在来源端没有任何附件，附件可下载率的分母为0，此时不应记为0%或100%，而应标注“该项目无附件，不参与附件指标汇总”，在总体结论中单独说明。同理，某类关联关系在来源端不存在时，对应指标也不参与汇总。
差异条目的记录要能支撑复核：每条差异写明对象标识、差异描述、归因类别、处理方式和复检结果。复检时只针对差异条目重新取数比对，不需要重跑全部指标。
判定标准与解读限制
通过标准应在迁移方案或验收约定中事先设定，按对象类型分别给出允许差异阈值，并说明依据。阈值没有通用值，取决于数据规模、业务对历史数据的依赖程度和修复成本。例如问题记录数可以要求零缺失，字段一致率可以允许少量差异但要求逐条登记并修复，评论和附件可以按抽检结果判定。
| 对象类型 | 建议判定方式 | 差异分级 |
|---|---|---|
| 项目与问题总量 | 要求与来源端一致，差异逐条登记 | 缺失记录属阻断性差异 |
| 关键字段值 | 按字段设定一致率阈值，不一致条目全部登记 | 影响业务判断的字段差异属阻断性差异 |
| 附件 | 可下载率达标，挂接关系正确 | 附件丢失或无法打开属阻断性差异 |
| 评论与状态历史 | 数量比对加抽检内容 | 影响追溯的缺失属阻断性差异，格式差异可接受 |
差异分级的作用是决定能否通过验收。阻断性差异指影响业务连续使用的缺失或错误，例如整条问题缺失、关键字段大面积不一致、附件无法打开，这类差异应修复后复检。可接受差异指不影响使用的格式或展示差异，例如富文本排版变化、时间显示格式不同，登记后即可关闭。
解读结论时要注意边界。完整性指标衡量的是数据迁移的到位程度，达标只说明数据按约定迁到了目标端，不能说明团队协作效率提升、交付周期缩短等业务效果，指标之间也不构成因果关系。核对结论还应写明覆盖范围、取数时间点和抽样方式，超出范围的对象不能套用该结论。结论由迁移负责人和业务方共同确认，证据材料按组织的数据管理要求保存，保存期限在验收约定中写明。
常见问题
迁移冻结后目标端还在写入新数据，核对数量对不上怎么办？
先确认两端取数时间点是否一致。建议在迁移冻结后、业务恢复写入前完成两端取数，并把取数时刻记录到具体日期和时间。如果目标端已经恢复写入，可以在取数条件中排除冻结时点之后新建的记录，或按创建时间区间截取到冻结时点，使两端范围等价。因取数时间差造成的数量差异属于统计口径差异，不应记为迁移遗漏。
问题量很大，字段值可以只抽样核对吗？
可以，但要区分指标。总量类指标建议全量比对，成本低且能发现整条记录缺失；字段值和评论内容可以抽样，抽样要说明方法和样本量，例如按问题类型分层、每层随机抽取不少于30条。写结论时注明“抽检”，抽样结果只代表样本覆盖的范围，不能表述为全量核对通过。
来源端字段本身为空，核对时算不算不一致？
取决于分母口径。字段非空一致率的分母用来源端该字段有值的记录数，来源端本身为空的记录不进入分母，这样衡量的是“有值的数据是否迁对”。如果来源端为空而目标端出现了值，应单独列为差异项核查。无论采用哪种口径，都要写进指标定义，并保证两端使用同一口径。
某个项目没有附件，附件指标怎么算？
分母为零时不记为0%或100%，应标注“该项目无附件，不参与附件指标汇总”，在总体结论中单独说明。同理，某类关联关系在来源端不存在时，对应指标也不参与汇总。这样处理可以避免用无意义的比例拉低或拉高整体结果。
完整性核对通过，能否说明迁移后团队效率提升了？
不能。完整性指标衡量的是数据按约定迁移到位的程度，与协作效率、交付周期等业务效果之间没有因果保证。结论应写明覆盖范围、取数时间点和抽样方式，超出范围的对象不能套用。若需要评估业务效果，应另行设计度量口径并单独取数。
