核对Jira附件迁移完整性，可以用文件数和字节大小两条线交叉验证：迁移前从源端导出附件清单，迁移后从目标端导出同结构清单，按附件标识或问题键加文件名逐条匹配。文件数回答“有没有丢”，字节大小回答“有没有变”，两者都通过且缺失清单为零，才能判定该批次附件迁移完整。核对前需要先划定批次范围、统一取数时点，并把零字节文件、同名多版本和迁移窗口内新增附件单独标注。
要点总览（TL;DR）
- 核对Jira附件迁移完整性，用文件数和字节大小两条线交叉验证：文件数回答“有没有丢”，字节大小回答“有没有变”，两者都通过且缺失清单为零才判定该批次完整。
- 文件数一致率的分母取源端迁移范围内附件条数，分子取目标端匹配成功条数；大小一致率在匹配成功的附件上逐条比对字节数，KB/MB换算仅用于展示。
- 匹配键优先用附件ID，目标端无对应标识时退化为问题键加文件名，并对同名多版本、重命名单独标记；零字节文件、迁移窗口内新增或删除的附件应单列，不直接计入失败。
- 核对流程固化为五步：建立匹配键、计算文件数一致率、计算大小一致率、输出缺失/多余/大小不一致三类清单、逐条复核归类原因；分母为零的批次标记为不适用。
- 通过判定分三档：两项一致率均达标且缺失清单为零为通过；存在可解释差异且已逐条复核为有条件通过；存在缺失或截断为不通过。阈值需结合业务容忍度自定。
核对目标与通过标准怎么定
附件迁移完整性核对要回答两个问题：迁移范围内的附件是否都到达目标端，到达的附件内容是否与源端一致。前者用文件数衡量，后者用字节大小衡量。只核对数量，可能漏掉上传中断造成的截断文件；只核对大小，可能忽略整条附件未迁移的情况。两项指标需要同时纳入判定。
核对单元建议按批次划分，一个批次可以是一个项目、一组问题类型或一个迁移时间窗。批次边界要在取数前写清楚，后续所有分子分母都限定在同一批次内。跨批次汇总时，先分别判定各批次，再合并统计，避免用总体一致率掩盖某个批次的集中缺失。
通过标准由三项构成：文件数一致率达到约定阈值、字节大小一致率达到约定阈值、缺失清单为零。阈值没有通用数字，需要迁移负责人根据附件对业务的重要程度设定。例如设计图纸、合同扫描件所在批次可以要求缺失清单为零且大小全部一致；普通截图类附件可以允许少量差异进入人工复核。下表可作为填写模板。
| 指标 | 口径 | 阈值（示例，需自定） | 判定类型 |
|---|---|---|---|
| 文件数一致率 | 目标端匹配成功条数 ÷ 源端范围内附件条数 | 100% | 阻断项 |
| 字节大小一致率 | 字节大小相同条数 ÷ 匹配成功条数 | 100% | 阻断项（截断类差异） |
| 缺失清单条数 | 源端存在、目标端未匹配到的附件条数 | 0 | 阻断项 |
| 多余清单条数 | 目标端存在、源端范围内无对应记录的附件条数 | 逐条说明 | 观察项 |
| 元数据差异 | 创建时间、上传人等字段不一致的条数 | 逐条说明 | 观察项 |
阻断项意味着该批次不能判定通过，需要补迁或重新核对；观察项记录在案，由业务方确认是否影响使用。把两类分开，可以避免因为一个时间戳偏差否定整批迁移，也可以防止把真实缺失当成“小问题”放过。
指标与统计范围：分母、单位与时间窗
文件数指标的分母是源端清单中落在迁移范围内的附件条数，分子是目标端匹配成功的条数。分母不取目标端条数，否则缺失的附件不会进入分母，一致率会虚高。大小指标在匹配成功的附件上逐条比对字节数，同时汇总源端总字节数与目标端总字节数，用差额辅助定位问题。
| 指标 | 公式 | 分子 | 分母 | 单位 |
|---|---|---|---|---|
| 文件数一致率 | 匹配成功条数 ÷ 源端范围内条数 × 100% | 目标端匹配成功的附件条数 | 源端迁移范围内附件条数 | 条、百分比 |
| 大小一致率 | 字节大小相同条数 ÷ 匹配成功条数 × 100% | 两端字节数完全相同的条数 | 匹配成功的附件条数 | 条、百分比 |
| 总字节差异 | 目标端总字节数 − 源端总字节数 | — | — | 字节 |
比对统一使用字节，KB、MB只在展示时换算，且保留换算口径说明，避免四舍五入后把相差几十字节的文件误判为一致。迁移范围可以按项目、问题类型、附件创建时间窗或附件ID区间圈定，圈定规则写入取数记录，后续复核沿用同一规则。
三类附件需要单列，不直接计入失败：零字节文件，两端都应为零字节，匹配成功即视为一致；迁移窗口内源端新增的附件，若不在本次迁移范围内，应从分母剔除并记录；源端已删除的附件，目标端不存在属于正常情况。分母为零的批次标记为“不适用”，不能写成100%。
数据口径与证据：两端清单怎么取
两端清单字段结构一致，才能逐条匹配。源端清单至少包含问题键、附件ID、文件名、字节大小、创建时间、上传人；目标端清单包含对应的问题键、附件标识、文件名、字节大小、创建时间。目标端若没有与源端同名的附件ID，需要保留迁移映射关系，或者退化为问题键加文件名作为匹配键。
| 字段 | 源端（迁移前快照） | 目标端（迁移后快照） | 用途 |
|---|---|---|---|
| 问题键 | 必填 | 必填 | 定位附件所属工作项 |
| 附件ID/附件标识 | 必填 | 有则必填 | 首选匹配键 |
| 文件名 | 必填 | 必填 | 辅助匹配、识别重命名 |
| 字节大小 | 必填 | 必填 | 大小比对 |
| 创建时间 | 必填 | 必填 | 划分时间窗、识别新增 |
| 上传人 | 建议填写 | 建议填写 | 元数据核对 |
取数时点要固定：源端快照在迁移开始前导出，目标端快照在迁移完成后、业务恢复写入前导出，两份记录各自标注时间戳。若迁移期间源端仍有用户上传附件，快照时间与迁移窗口的错位会制造“多余”或“缺失”的假象，需要在差异复核时对照时间戳排除。
导出文件、匹配脚本输出、差异清单和复核结论一并归档，形成可追溯的证据链。字段缺失或无法批量导出时，可以按问题逐页人工记录，但这种方式覆盖范围有限、耗时长，只适合小批次补充核对，不宜作为主口径。
计算与核对步骤：从匹配到差异清单
核对流程可以固化为五步，每一步产出可复算的结果文件。
- 建立匹配键。优先用附件ID一对一匹配；目标端无对应标识时，用问题键加文件名匹配，并对同名多版本单独标记。
- 计算文件数一致率：匹配成功条数 ÷ 源端范围内条数 × 100%。同时输出未匹配的源端条目，即缺失清单。
- 计算大小一致率：在匹配成功的条目中，统计字节大小完全相同的条数，除以匹配成功条数 × 100%。
- 输出三类差异清单：缺失清单、多余清单、大小不一致清单。多余清单指目标端存在但源端范围内无对应记录的附件。
- 逐条复核差异项并归类原因，如上传中断、源端窗口内新增、同名覆盖、重命名等，形成复核记录。
分母为零时，该批次标记为不适用，并在汇总表中单独列出，不参与总体一致率计算。大小不一致的条目要记录两端字节数差额，差额接近文件头长度或分片大小的，通常指向传输截断，应优先安排重新迁移。
在ONES承接迁移后管理的场景中，附件随工作项一起进入项目空间，核对时可按项目或工作项范围导出附件信息，与迁移前清单对照。ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，迁移问题数据包括属性和属性值、附件、评论等信息，这为按工作项组织两端清单提供了对应关系。清单导出、条数与字节比对、核对报告是否由产品直接提供，需在迁移实施前与厂商确认。
算例：一个批次的实际核对过程
以下为演示数据，用于说明公式代入方式，不代表任何真实迁移结果。
某批次迁移范围为项目A中120个工作项的附件。源端快照记录附件500条，总字节数2,048,000,000字节。迁移完成后目标端快照匹配到499条，其中498条字节大小与源端完全相同，1条字节数偏小。
| 项目 | 数值 | 说明 |
|---|---|---|
| 源端范围内附件条数 | 500 | 分母 |
| 目标端匹配成功条数 | 499 | 文件数分子 |
| 文件数一致率 | 499 ÷ 500 × 100% = 99.8% | 缺失1条 |
| 匹配成功中大小相同条数 | 498 | 大小分子 |
| 大小一致率 | 498 ÷ 499 × 100% ≈ 99.80% | 大小不一致1条 |
| 目标端总字节数 | 2,047,800,000 | 差额 −200,000字节 |
差异清单显示：缺失1条为问题A-102的“接口文档.pdf”，源端大小1,200,000字节；大小不一致1条为问题A-215的“测试报告.xlsx”，源端800,000字节、目标端600,000字节，差额200,000字节，与总字节差额吻合。复核发现前者在迁移窗口内被源端用户删除，属于合理差异，应从分母剔除后重算；后者为传输截断，需要重新迁移。
剔除合理差异后，分母为499，匹配成功499，文件数一致率100%；大小一致率仍为498 ÷ 499，未达标。该批次结论为“不通过”，待截断文件补迁后重新核对。若两项一致率均达标且缺失清单为零，结论为“通过”；存在已逐条复核并记录原因的观察项、阻断项为零时，可写“有条件通过”。
结果解读与限制：哪些差异不能直接判失败
同名多版本附件是常见歧义来源。同一工作项下存在多个同名文件时，仅靠问题键加文件名无法区分版本，匹配可能错位，表现为一条“缺失”加一条“多余”。这类情况应回到附件ID或创建时间排序后重新匹配，确认后再判定。
零字节文件两端都为零字节时视为一致，不应因为“文件为空”计入异常。迁移窗口内新增或删除的附件，只要时间戳落在窗口内且有操作记录，属于合理差异，从分母剔除或列入观察项。重命名附件在文件名匹配下会显示为缺失加多余，需要结合大小和创建时间确认是否为同一文件。
字节大小一致只说明长度相同，不能证明内容可读。建议对大小不一致项全部打开验证，并对每类附件抽样打开，确认文件可正常预览或下载。单批次的一致率只反映该批次，不能代表全部迁移质量，需要按项目或时间窗汇总后再对外说明整体情况。
这些指标提供的是完整性证据，用于判断附件是否按范围到达且字节未变，不构成迁移成功或业务可用的因果保证。业务可用还涉及权限、关联关系和使用习惯，需要另行验证。
常见问题
迁移窗口内源端用户新增或删除了附件，核对时应该怎么处理？
先对照源端快照时间戳和迁移窗口，确认附件操作是否发生在窗口内。若新增附件不在本次迁移范围内，应从分母中剔除并记录；若删除发生在窗口内且有操作记录，目标端不存在属于合理差异，同样从分母剔除或列入观察项。剔除后重新计算一致率，并在核对报告中说明剔除条数和原因，避免直接判为缺失或多余。
同名多版本附件导致匹配错位，文件数一致率偏低，如何修正？
仅靠问题键加文件名无法区分同名多版本，容易出现一条“缺失”加一条“多余”的假象。修正方法是回到附件ID或创建时间排序后重新匹配，确认每个版本的一一对应关系。若目标端没有保留附件ID，可用创建时间加字节大小组合辅助区分。修正后重新计算一致率，并在差异清单中标注匹配键的调整过程。
字节大小一致是否就能说明附件迁移完整、内容可用？
字节大小一致只说明长度相同，不能证明文件内容可读或未损坏。建议对大小不一致项全部打开验证，并对每类附件抽样打开，确认可正常预览或下载。完整性指标提供的是“按范围到达且字节未变”的证据，业务可用还涉及权限、关联关系和使用习惯，需要另行验证。
ONES在Jira附件迁移后，能否直接导出附件清单做条数和大小比对？
ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，迁移问题数据包括属性和属性值、附件、评论等信息，附件随工作项进入项目空间，可按项目或工作项范围组织两端清单的对应关系。清单导出、条数与字节比对、核对报告是否由产品直接提供，现有资料未提及，建议在迁移实施前与厂商确认具体能力。
某个批次分母为零时，一致率应该写100%还是0%？
分母为零表示该批次在迁移范围内没有附件，一致率没有定义，应标记为“不适用”，不能写成100%或0%。在汇总表中单独列出该批次，不参与总体一致率计算，避免用无意义的百分比影响整体判断。
