Jira数据迁移完成后发现字段错位或数据丢失，原因通常集中在四类：字段映射与类型不匹配、迁移范围与过滤条件设置不当、源数据存在脏值或依赖缺失、导入批次与执行顺序问题。排查时先按现象归类，再用少量样本比对验证假设，确认原因后再决定补迁、重映射或回滚重做。
要点总览（TL;DR）
- Jira数据迁移后的异常集中在四类原因：字段映射与类型不匹配、迁移范围与过滤条件不当、源数据脏值与依赖缺失、导入批次与执行顺序问题。
- 先按现象归类：记录条数正常但字段值不可信多为错位，记录、附件、评论或关联关系减少多为丢失，两者可能并存。
- 判断依据看异常分布：某字段全部记录一致异常指向映射配置，同一字段只有部分记录异常且带共同特征更可能是数据本身问题。
- 处置按已确认原因选择修正映射后重导、补迁缺失范围、清洗脏值后重试或回滚重做，操作前保留源端与目标端备份。
- 恢复后做抽样与全量两层验证，并把字段映射表、数量对照表固化为迁移检查清单，用于下次迁移前预检和试迁移。
先分清是字段错位还是数据丢失
字段错位和数据丢失的处置方向不同，混在一起排查容易把映射问题误判成数据丢失，导致不必要的重导。第一步是按现象归类，并界定影响范围。
字段错位的典型表现有三类：值落到了错误的字段上，例如“故事点”出现在“优先级”字段；选项显示异常，例如单选值变成空白或显示为原始ID；多值字段被截断，例如多个负责人只剩第一个。这类问题通常记录条数正常，但字段内容不可信。
数据丢失的典型表现是数量或结构上的缺失：目标端记录条数少于源端、附件或评论缺失、父子任务与问题链接等关联关系断裂。两者也可能并存，例如某类问题整体未迁入，同时已迁入记录的字段值错位。
| 现象 | 初步归类 | 优先核对 |
|---|---|---|
| 值落到错误字段、选项显示异常 | 字段错位 | 字段映射与类型对应 |
| 多值字段只剩部分值 | 字段错位 | 多值字段映射限制 |
| 记录条数减少 | 数据丢失 | 迁移范围与过滤条件 |
| 附件、评论缺失 | 数据丢失 | 迁移内容勾选项 |
| 父子任务、链接断裂 | 数据丢失 | 批次顺序与依赖对象 |
确定影响范围时，按项目、问题类型、字段三个维度各抽10至20条记录，与源端逐条比对，统计错位字段数和缺失记录数。抽样覆盖不同创建时间段和不同经办人，避免只抽近期数据。影响面清单应写明：涉及哪些项目、哪些字段、缺失的是记录还是附件评论、是否影响进行中的工作项。
字段映射与类型不匹配如何造成错位
字段层面的错位，多数源于源端字段在目标端找不到结构对等的落点。迁移工具需要把Jira的自定义字段逐一对到目标系统的字段，对应关系缺失或不准确时，值就会落到默认字段、被丢弃或显示异常。
常见情形包括：
- 自定义字段类型无对应结构。Jira中的级联选择、多复选框、URL、标签等字段类型，在目标端若没有同类型字段，迁移时可能被降级为文本，选项值变成一串字符，或整列被跳过。
- 选项值与状态映射缺失。单选、多选字段的选项需要逐项建立对应关系，状态还需要映射到目标端工作流的状态。映射表缺项时，未覆盖的选项显示为空或保留原值，状态则可能全部落到同一个默认状态。
- 多值字段与富文本、附件字段的映射限制。多值字段在目标端被建成单值字段时只保留一个值；富文本中的图片、表格在转换中可能丢失格式；附件字段若未单独配置迁移，文件不会随记录带入。
验证方法是选取少量样本记录，制作逐字段比对表：源端字段名、字段类型、值，目标端对应字段、实际值、是否一致。重点检查有选项的字段和含多个值的字段。若同一字段在全部样本中都错位，指向映射配置问题；若只有部分记录异常，更可能是数据本身的问题，转入下一节排查。
迁移范围与过滤条件导致的数据缺失
记录条数减少、附件评论缺失，通常与字段映射无关，而是迁移时圈定的范围小于实际需要。这类问题在迁移完成后才暴露，因为迁移过程本身可能没有报错。
范围类原因主要有三种：
- 只迁移了部分项目或问题类型。迁移配置中按项目、问题类型、时间范围设置过滤条件时，未勾选的项目或子任务、缺陷等类型不会进入目标端，表现为整类记录缺失。
- 附件、评论、历史变更记录被排除。这些内容往往需要单独勾选迁移，默认配置可能只迁问题主体。缺失表现为记录在但详情不全。
- 分批导入与执行顺序问题。分多个批次导入时，若子任务先于父任务、链接两端不在同一批次，关联关系会断裂；重复导入同一批次则可能产生重复记录或覆盖已有数据。
核对方法是做源端与目标端的数量对照：按项目统计问题总数、子任务数、附件总数、评论总数，逐项比对差异。差异集中在某一项目或某一问题类型，指向过滤条件；差异集中在附件和评论，指向迁移内容勾选；记录数对得上但关联断裂，指向批次顺序。
源数据脏值与依赖缺失的排查
映射配置正确、范围也完整，仍然出现错位或导入失败时，问题往往在数据本身。Jira长期使用后积累的脏数据和目标端不存在的依赖对象，会在迁移时集中暴露。
依赖对象缺失是常见原因。经办人、报告人对应的用户若未在目标端创建，字段会显示为空或落到默认用户；状态、优先级、问题类型等枚举值若在目标端没有同名或已映射的项，记录可能导入失败或被归入默认值。排查时先导出源端使用到的用户列表和枚举值列表，与目标端逐一核对。
数据格式问题同样会引发异常：必填字段为空导致记录被跳过；超长文本超出目标字段长度限制被截断；特殊字符、换行符、表情符号在导入解析时造成失败或乱码。关联关系方面，父子任务、问题链接、修复版本、冲刺归属等依赖其他记录的字段，若对端记录未迁入，关联会静默丢失。
区分数据问题与映射问题的判断依据是异常分布：映射问题通常表现为某字段全部记录一致异常；数据问题表现为同一字段只有部分记录异常，且异常记录往往有共同特征，例如都缺少经办人、文本都超过一定长度。按特征筛选出异常记录单独核对，能较快定位。
按原因处置：补迁、重映射还是回滚重做
原因确认后再选处置方式，不同原因的处置成本和风险差别很大。处置前先对源端和目标端各做一次快照或导出备份，保留回退余地。
| 已确认原因 | 处置方式 | 风险边界 |
|---|---|---|
| 字段映射错误或类型不对应 | 修正映射关系，重导受影响字段或记录范围 | 重导前确认不会覆盖已人工修正的目标端数据 |
| 范围过滤导致记录缺失 | 调整过滤条件补迁缺失项目或类型，再校验关联 | 补迁批次需保证父子任务、链接两端同批或按依赖顺序执行 |
| 附件、评论未勾选 | 单独补迁附件与评论，按记录ID对应 | 核对附件数量与文件大小，避免重复附件 |
| 脏值导致截断或失败 | 清洗源数据后重试失败记录 | 清洗前保留原始数据备份，清洗规则需业务确认 |
| 批次顺序导致关联断裂 | 按依赖顺序补建关联关系 | 先确认两端记录均已存在，再重建链接 |
需要回滚重做的条件通常是：错位涉及多个核心字段且已有人工修改混入、重复导入造成大面积重复记录、或缺失范围无法通过补迁覆盖。回滚前明确停止点：确认源端数据完整可用、目标端试运行期间产生的新数据已单独导出、回滚窗口与业务使用时间错开。若目标端已开始正常使用，优先选择局部补迁和修正，避免整体回滚带来的二次中断。
在ONES的Jira迁移方案中，迁移内容覆盖项目、工作项、状态、字段、流程、附件和历史记录，也支持迁移用户、用户组以及问题类型、工作流、字段配置等系统配置，问题数据包含属性值、附件和评论。这意味着字段映射和范围核对可以在迁移配置阶段逐项确认；对于依赖Jira插件的定制场景，ONES建议迁移前逐项评估，避免假设插件功能能一一对应。实际处置时，补迁与重导的具体操作仍以所用迁移工具的配置项为准。
恢复后的验证与复发预防
补迁或重导完成后，需要验证恢复是否完整，并把这次暴露的问题固化为下次迁移的检查项。
验证分两层。抽样验证针对字段：按项目各抽20条记录，逐字段比对源端与目标端的值、选项显示、多值完整性。全量验证针对数量与关联：比对问题总数、子任务数、附件总数、评论总数，抽查父子任务和问题链接是否可正常跳转。验证通过标准应在迁移前约定，例如记录数一致、核心字段抽样一致率100%、附件数量一致、关联关系无断裂。责任人建议由业务侧数据负责人确认字段语义正确，由迁移执行人确认数量与关联完整。
预防措施集中在迁移前：
- 做字段映射预检，列出源端全部自定义字段、类型和使用量，逐项确认目标端落点，选项值建立完整映射表。
- 先做小范围试迁移，选一个代表性项目完整走一遍，用试迁移结果修正映射和范围配置。
- 迁移前清洗明显脏数据，补齐目标端用户和枚举值，确认附件与评论的迁移勾选。
- 把本次的核对表、映射表、数量对照表固化为迁移检查清单，下次迁移按清单逐项打勾后再执行正式迁移。
常见问题
迁移后记录条数对得上，但部分字段值是空的，应该先查映射还是先查数据？
先看空值的分布。如果某个字段在全部记录上都为空，优先检查字段映射：目标端可能没有对应字段，或映射关系未建立，值在导入时被丢弃。如果只有部分记录为空，且这些记录有共同特征，例如经办人未在目标端创建、选项值不在映射表内，则更可能是数据或依赖对象问题。两种情况的验证方式不同，先归类能避免无效重导。
分批迁移时，怎样避免父子任务和问题链接断裂？
关键是保证有依赖关系的记录在同一批次，或按依赖顺序执行：先迁父任务再迁子任务，先迁链接两端记录再重建链接。分批方案设计时，把关联关系作为分批依据之一，而不是只按项目或时间切分。每批完成后抽查关联是否可正常跳转，发现问题在该批次内修正，避免累积到全部迁移结束后再排查。
目标端已经开始正常使用，还能回滚重做吗？
可以回滚，但成本和中断风险明显高于迁移刚完成时。回滚前需要确认：源端数据仍完整可用、目标端试运行期间产生的新数据已单独导出、回滚窗口与业务使用时间错开。若目标端已进入日常使用，优先选择局部补迁和字段修正，只对无法通过补迁覆盖的范围评估回滚。是否回滚应以影响面清单和业务侧确认作为判断依据，避免整体回滚带来二次中断。
使用ONES的Jira迁移方案时，字段和范围的核对能在哪个阶段完成？
ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，也支持迁移用户、用户组以及问题类型、工作流、字段配置等系统配置，问题数据包含属性值、附件和评论。字段映射和迁移范围可以在迁移配置阶段逐项确认。对于依赖Jira插件的定制场景，ONES建议迁移前逐项评估，避免假设插件功能能一一对应。具体补迁与重导操作以所用迁移工具的配置项为准。
迁移前做多大规模的试迁移比较合适？
试迁移的目的是验证映射和范围配置，规模不必大，但要覆盖代表性。建议选一个字段使用较全、问题类型较齐的项目完整走一遍，确保包含自定义字段、多值字段、附件、评论和子任务。试迁移后逐字段比对并核对数量，用发现的问题修正映射表和过滤条件，再执行正式迁移。只抽几条记录试迁，往往暴露不出选项映射和关联关系的问题。
