Jira 迁移工具选型清单要解决的是把“迁移能不能做、数据准不准、迁完能不能用”变成可逐项判断的检查项。它适用于选型评估、试迁移和正式切换前验收三个节点，每项检查都要写明通过标准、证据形式和负责人。本文按阶段给出可直接使用的检查表，并标出阻断项与放行条件。
要点总览（TL;DR）
- 选型阶段先核验迁移工具的数据对象范围、字段与状态映射、历史数据保真、权限与通知、集成与自动化，以文档、演示和测试报告作为证据，口头承诺不作为放行依据。
- 准备阶段固定迁移范围、源端信息、目标端配置、账号映射规则和切换窗口，每项标注负责人与完成时点，未完成的输入项列为阻断。
- 试迁移验收用数量核对加分层抽样比对判断，抽样比例在验收前书面约定，比对记录要能追溯到具体问题编号。
- 阻断项在试迁移前确定划分口径；正式切换需同时满足阻断项全部关闭、抽样通过率达到约定阈值、回退方案完成演练三条。
- 切换后设置观察期，首周核对新增数据写入并收集用户反馈，观察期结论作为后续批次迁移的输入。
谁在什么时点使用这份清单
这份清单面向 Jira 替换项目的迁移负责人、Jira 管理员、业务线代表以及测试与运维人员。它判断的对象是迁移工具的能力和迁移结果，不涉及 Jira 日常使用教学，也不替代具体的数据迁移技术方案。不同角色在项目中的关注点不同，使用清单的时点也不同。
| 角色 | 主要使用时点 | 在清单中承担的动作 |
|---|---|---|
| 迁移负责人 | 选型评估、试迁移、切换前验收 | 组织检查、汇总结论、判断阻断项是否关闭、签署放行 |
| Jira 管理员 | 选型评估、准备阶段、试迁移 | 提供源端信息、核对字段与状态映射、执行抽样比对 |
| 业务线代表 | 准备阶段、试迁移验收 | 确认迁移范围与业务口径、参与内容抽样、确认遗留问题 |
| 测试与运维 | 试迁移、切换与观察期 | 验证附件可用性、集成与自动化、执行回退方案演练 |
三个使用时点各有侧重：选型评估阶段回答“候选工具能不能覆盖我们的数据对象和迁移要求”；试迁移阶段回答“实际迁出来的数据对不对”；正式切换前验收回答“剩余问题是否允许上线”。每次检查都要记录检查日期、检查人和结论，避免同一项在不同阶段得出互相矛盾的判断。清单本身不覆盖 Jira 日常使用教学，也不对具体产品的版本、价格或认证作结论，这些需要另行查证。
选型阶段：先核验迁移工具的能力边界
选型阶段的目标是在投入试迁移之前，用可核验的问题筛掉能力明显不匹配的候选。判断依据以厂商文档、产品演示和试迁移测试报告为主，口头承诺不作为放行依据。下表列出核验项、通过标准与需要索取的证据。
| 核验项 | 通过标准 | 需索取的证据 | 负责人 |
|---|---|---|---|
| 数据对象范围 | 问题、子任务、评论、附件、工作日志、版本、组件、自定义字段均在支持清单内，缺失项有明确说明 | 迁移能力文档、对象清单对照表 | Jira 管理员 |
| 字段与状态映射 | 支持映射表配置，能处理默认值与空值，映射冲突有提示机制 | 映射配置演示、冲突处理说明 | Jira 管理员 |
| 历史数据保真 | 创建时间、更新时间、原始作者、状态流转历史的保留口径有书面说明 | 字段保留说明、样例迁移结果 | 迁移负责人 |
| 增量与重复迁移 | 支持多次试迁移，重复数据有识别与覆盖策略 | 迁移机制说明、试迁移记录 | 迁移负责人 |
| 权限与通知 | 权限方案可迁移或重建，迁移期间通知有抑制手段，订阅关系处理方式明确 | 权限迁移说明、通知策略配置 | 运维 |
| 集成与自动化 | Webhook、CI 集成、自动化规则有迁移或重建方案，并可在目标端验证 | 集成清单、重建方案、验证记录 | 测试与运维 |
核验时要把“支持”拆到具体对象和具体行为。例如“支持自定义字段”需要进一步确认字段类型覆盖范围、单选多选值的对应关系、必填校验在迁移中如何处理。对于来源资料未明确的能力，例如增量迁移机制、时间戳与原始作者的保留口径、Jira 版本与部署方式的兼容范围，应在选型阶段直接向厂商确认并留下书面答复，不能留到试迁移时再发现。插件依赖同样需要先梳理实际使用清单，再逐项评估替代或重建方案，不默认所有插件都能一一对应。
准备阶段：迁移前必须确认的输入项
准备阶段要把迁移范围、口径和资源固定下来，减少试迁移反复。每一项都要标注负责人和完成时点，未完成的输入项列为阻断，不进入试迁移。
| 输入项 | 需确认的内容 | 完成标志 | 负责人 |
|---|---|---|---|
| 迁移范围清单 | 项目数量、问题总量、附件体量、时间跨度 | 范围清单经业务线代表确认 | 迁移负责人 |
| 源端信息 | Jira 版本、部署方式、插件依赖、自定义字段清单 | 源端信息表填写完整并核对 | Jira 管理员 |
| 目标端准备 | 项目结构、字段方案、状态机、用户与用户组对应关系 | 目标端配置完成并通过内部评审 | Jira 管理员 |
| 账号映射规则 | 同名、异名、离职账号、外部协作者的处理方式 | 映射规则书面确认，异常账号有处理结论 | 运维 |
| 环境与窗口 | 试迁移环境、正式切换时间窗、回退方案 | 环境可用，切换窗口与回退步骤经评审 | 运维 |
账号映射是最容易被低估的输入项。同名账号可以直接对应，异名账号需要人工确认，离职账号和外部协作者则要事先决定是保留为历史作者还是归并到公共账号，这个决定会影响后续历史记录的显示口径。回退方案要在准备阶段完成演练，而不是写在文档里就算完成：至少验证一次从目标端恢复到切换前状态的操作路径，并记录耗时。
试迁移与验收：用抽样比对判断是否通过
试迁移验收的核心方法是对比，判断结论要建立在数量核对和分层抽样的结果上。抽样比例由迁移规模和风险等级共同确定，并在验收前书面约定，避免事后争议。下表给出检查项、通过标准、证据形式与负责人。
| 检查项 | 通过标准 | 抽样与证据 | 负责人 |
|---|---|---|---|
| 数量核对 | 各项目问题数、子任务数、评论数、附件数与源端一致，差异有解释 | 源端与目标端数量比对表 | Jira 管理员 |
| 内容抽样 | 按项目、字段类型、状态类型分层抽样，字段值与正文逐条一致 | 抽样清单与逐条比对记录 | 业务线代表、Jira 管理员 |
| 附件与富文本 | 附件可下载可预览，图片与表格在正文中正常显示 | 截图、抽检记录 | 测试 |
| 历史与时间 | 状态流转历史、创建与更新时间、原始作者显示正确 | 样例问题前后对照 | Jira 管理员 |
| 权限与通知 | 目标端可见范围符合预期，迁移过程未产生批量误通知 | 权限矩阵核对表、通知日志 | 运维 |
| 集成与自动化 | 关键 Webhook、流水线触发、自动化规则在目标端验证通过 | 触发日志、验证记录 | 测试与运维 |
抽样要覆盖不同类型的对象，而不是只挑几条最新问题。建议按项目分层，每个项目内再按字段类型和状态类型分层，重点抽取包含附件、富文本、多次状态流转和跨项目关联的问题。比对记录要能追溯到具体问题编号，出现差异时记录差异类型、影响范围和修复结论。数量核对出现差异时，先判断是迁移遗漏还是源端统计口径不同，再决定是否列为阻断。
验收过程中的比对记录、遗留问题和评审结论需要有统一的承载位置。ONES 的项目与工作项可以按迁移批次建立检查任务，把每项检查的负责人、结论和证据挂在对应工作项下；验收结论和遗留问题清单可以放在文档中，由迁移负责人和业务线代表在同一处完成确认。这样切换放行时，判断依据和签字记录能对应到同一份材料。
阻断项与完成条件：什么情况下不能切换
阻断项和非阻断项应在试迁移开始前确定划分口径，避免验收时临时争论。判断原则是：影响核心业务连续或造成数据不可信的问题列为阻断，其余登记为遗留问题并约定修复时点。
| 类别 | 示例 | 处理方式 |
|---|---|---|
| 阻断项 | 关键项目数据缺失、附件大面积不可用、权限越权可见、核心集成中断 | 必须关闭后才能进入正式切换 |
| 非阻断项 | 个别非关键字段显示格式差异、低频自动化规则待重建 | 登记遗留问题，约定修复时点与责任人 |
正式切换的放行条件包括三条：阻断项全部关闭；抽样比对通过率达到验收前约定的阈值；回退方案已完成演练并确认可用。三条同时满足才签署放行，任一条不满足则推迟切换。放行确认由迁移负责人、业务线代表和运维负责人共同签字，签字记录与验收材料一并归档。
切换后设置观察期，首周安排数据核对和用户反馈收集：每天核对新增问题、评论和附件的写入是否正常，收集用户对字段显示、通知和权限的实际反馈，发现异常按回退方案评估处理。观察期结束后形成迁移总结，把遗留问题的修复进度和观察期发现的问题一并记录，作为后续批次迁移的输入。
常见问题
迁移工具声称支持某个数据对象，选型时还要追问什么？
把“支持”拆到具体对象和具体行为再确认。以自定义字段为例，需要进一步问清字段类型覆盖范围、单选多选值的对应关系、必填校验在迁移中如何处理、空值和默认值怎么落。工作日志、版本、组件这类对象也要逐项确认是否在迁移范围内，缺失项要求厂商给出明确说明。追问结果以书面答复或演示记录留存，作为选型判断的依据。
试迁移做几轮、抽样比例定多少比较合适？
轮次和比例没有统一数值，取决于项目数量、问题总量和风险等级。可行的做法是在验收前书面约定：先按项目分层，每个项目内再按字段类型和状态类型分层，重点抽取包含附件、富文本、多次状态流转和跨项目关联的问题。约定后按同一口径执行，出现差异时记录差异类型、影响范围和修复结论。若首轮发现系统性差异，修复后重新执行一轮完整比对，而不是只补查差异点。
数量核对对不上，是不是一定算阻断？
先判断差异来源再定性。差异可能来自迁移遗漏，也可能来自源端统计口径不同，例如已删除问题、归档项目或子任务是否计入总数。确认是迁移遗漏且涉及关键项目时列为阻断；属于统计口径差异的，在比对表中写明口径并留档。判断结论要由迁移负责人和 Jira 管理员共同确认，避免同一项在不同阶段得出互相矛盾的结论。
插件和自动化规则在迁移中怎么处理？
先梳理实际使用的插件和自动化规则清单，再逐项评估替代或重建方案，不默认所有插件都能一一对应。企业已有的定制场景在迁移前需要单独评估。Webhook、CI 集成和自动化规则要在目标端实际触发验证，用触发日志作为证据，验证通过才计入验收结论。
回退方案要验证到什么程度才算可用？
至少完成一次从目标端恢复到切换前状态的操作演练，并记录耗时和操作步骤。演练在准备阶段完成，而不是写在文档里就算完成。放行时回退方案需处于已验证状态，切换窗口和回退步骤经运维评审。观察期内发现异常时，按已验证的回退路径评估处理。
