迁移研发数据时，评论、变更历史、附件、关联链接以及操作人和时间戳，都属于历史记录遗漏的典型范围。判断一条记录是否纳入，看它是否承载“谁在何时因何做了什么”的过程信息；工作流配置、插件行为和迁移后的结果核验不在本文讨论之内。
要点总览（TL;DR）
- 历史记录遗漏指迁移后目标系统中缺失或失真的、依附于工作项的过程性记录，判断口径是这条记录是否承载“谁在何时因何做了什么”的过程信息。
- 典型纳入范围包括评论与回复、字段变更历史与状态流转记录、附件及版本、关联链接与父子关系，以及操作人与时间戳等元数据。
- 工作流配置、状态机定义、插件行为归工作流与扩展能力迁移；迁移后的结果核验与切换回退归迁移验证与切换管理，均不在本文范围。
- 评论与变更历史常存于独立表或事件流、附件依赖文件加引用、关联链接要求两端对象已建立、操作人受账号映射影响，这些结构差异是遗漏的主要成因。
- 字段当前值属于工作项数据，字段变更历史属于过程记录；当前值正确不能说明历史完整，变更历史也无法由当前值反推。
历史记录遗漏指哪些内容
历史记录遗漏，指迁移完成后目标系统中缺失或失真的、依附于工作项的过程性记录。它描述的是记录层面的不完整，关注工作项从创建到当前状态之间发生过什么，以及这些过程信息能否在目标系统中被完整还原。
按这个定义，典型的历史记录包括以下几类：
- 评论与回复：工作项下的讨论内容、回复层级、评论中的提及对象，以及评论附带的图片或文件。
- 字段变更历史与状态流转记录：字段值从旧值变为新值的时间点、操作人，状态在流程节点之间的流转轨迹。
- 附件及其版本：附件文件本身、附件与工作项的引用关系，以及同一附件的多个版本。
- 关联链接与父子关系：工作项之间的阻塞、关联、重复关系，父任务与子任务的层级结构。
- 操作人与时间戳等元数据：每条记录的创建人、修改人、发生时间，以及记录来源。
判断口径可以归纳为一句话：这条记录是否承载了“谁在何时因何做了什么”的过程信息。承载了，就属于历史记录；只描述当前状态、不反映过程演变的字段值，属于工作项数据本身，不单独构成历史记录。
边界：哪些算遗漏，哪些不算
概念边界决定迁移范围的划分。历史记录遗漏的纳入项，是依附于工作项的过程记录及其元数据；排除项主要涉及流程配置、插件行为和迁移后的核验工作，它们各自归属相邻主题。
| 对象 | 是否纳入历史记录遗漏 | 说明 |
|---|---|---|
| 评论与回复 | 纳入 | 承载讨论过程和决策依据 |
| 字段变更历史、状态流转记录 | 纳入 | 反映工作项状态演变 |
| 附件及版本、附件引用关系 | 纳入 | 文件内容与挂载关系同属过程记录 |
| 关联链接、父子关系 | 纳入 | 记录工作项之间的依赖与结构 |
| 操作人、时间戳、记录来源 | 纳入 | 过程信息的必要组成部分 |
| 工作流配置、状态机定义 | 排除 | 归工作流与扩展能力迁移 |
| 插件行为与扩展脚本 | 排除 | 归工作流与扩展能力迁移 |
| 迁移后的结果核验、切换与回退 | 排除 | 归迁移验证与切换管理 |
边界模糊的情形主要出现在字段值本身与字段变更历史之间。字段的当前值属于工作项数据，迁移时随主数据一起搬运；字段的变更历史属于过程记录，记录的是这个值曾经是什么、何时被谁改过。举例来说，缺陷的优先级当前是“高”，这个值迁过去属于数据迁移；而“三天前由测试人员从‘中’改为‘高’”这条记录，属于历史记录。前者缺失是字段映射或数据丢失问题，后者缺失才是历史记录遗漏。
在工具承载层面，工作项的过程记录通常以评论、活动日志、附件区和关联关系的形式挂在同一个工作项下。ONES 的 Jira 迁移方案围绕项目、工作项、状态、字段、流程、附件和历史记录展开，其 Jira 数据迁移能力提到可迁移问题数据，包括属性和属性值、附件、评论等信息。这些描述说明评论、附件等记录在迁移方案中有对应位置；具体到字段变更历史、关联链接和操作人时间戳的逐项覆盖范围，仍需在迁移方案评估阶段确认。
这些记录在迁移中如何产生遗漏
历史记录遗漏的形成，根源在于过程记录与主数据在存储结构、引用方式和身份标识上存在差异。主数据迁移成功，只说明工作项的标题、状态、负责人等当前值已经落位，过程记录往往走的是另一条迁移链路。
评论与变更历史常以独立表或事件流存储。很多研发管理系统把评论、活动日志、字段变更记录放在独立的数据表中，与工作项主表通过 ID 关联。迁移工具如果按主表字段做映射，这些独立表容易被整体跳过；即使纳入迁移，事件流中的记录顺序、记录类型也需要逐条映射，映射规则不完整时会出现部分记录缺失。
附件以文件加引用的方式存储。附件通常由文件存储服务和数据库中的引用记录两部分组成。迁移时文件被搬到新存储位置，引用记录中的路径、文件 ID 需要同步更新；路径规则或权限模型变化后，引用可能指向不存在的文件，表现为附件条目还在、点开却无法下载。附件多版本场景下，版本链的映射更容易被简化成只保留最新版本。
关联链接跨工作项甚至跨项目。关联关系要求两端对象在目标系统中都已建立。迁移按批次进行时，如果关联的一端尚未迁入，链接就无法落位；跨项目关联还涉及目标项目的可见范围和权限，处理不当会出现链接丢失或指向错误对象。
时间戳与操作人受账号映射影响。操作人需要从源系统账号映射到目标系统账号，映射表缺失或账号未建立时，记录的操作人可能变成系统账号或空值；时间戳在时区转换、导入批次处理中也可能被改写。这类问题表现为失真而非缺失，记录还在，但“谁在何时”的信息已经不可靠。
这几种机制叠加，使得评论、变更历史和附件成为迁移链路中最容易被忽略的部分。迁移范围清单如果只按工作项字段列项，过程记录就不在检查视野内。
与相邻概念的区别
历史记录遗漏容易与几个相邻概念混用，区分它们有助于把问题归到正确的处理环节。
| 概念 | 核心特征 | 与历史记录遗漏的区别 |
|---|---|---|
| 整体数据丢失 | 迁移后成批数据未到达目标系统 | 遗漏是局部、特定类型的缺失，工作项主体通常已迁入 |
| 字段映射错误 | 字段值在迁移中被错误转换或截断 | 映射错误是值失真，遗漏是记录缺失；前者改映射规则，后者补迁移范围 |
| 工作流与扩展能力迁移 | 流程定义、状态机、插件行为的搬迁 | 后者关注配置与行为能否在新系统运行，不涉及过程记录本身 |
| 迁移验证与切换管理 | 核验迁移结果、执行切换与回退 | 验证是发现遗漏的手段，遗漏是验证要检查的对象 |
这四组区别对应不同的处理动作：整体数据丢失要排查迁移任务是否执行完整；字段映射错误要修正映射规则并重跑；工作流与扩展能力迁移要评估配置兼容性；历史记录遗漏则要回到迁移范围清单，把过程记录类型补进去，再通过验证环节确认补齐结果。
一个具体例子与常见误解
假设一个缺陷工作项从旧系统迁入新系统。迁移完成后检查发现：标题、描述、优先级、当前状态都在，负责人也正确；但工作项下没有任何评论，状态变更记录为零，附件区为空，而原系统中该缺陷有 5 条评论、3 次状态变更和 2 个附件。
逐项判断：5 条评论属于评论记录，缺失构成历史记录遗漏；3 次状态变更属于状态流转记录，缺失构成遗漏；2 个附件属于附件及引用关系，缺失构成遗漏。如果附件条目存在但下载失败，同样属于遗漏，表现为引用失效。如果评论还在但操作人显示为系统账号，属于元数据失真，也计入遗漏范围。标题和当前状态正常，说明主数据迁移成功，但这不能抵消过程记录的缺失。
围绕这个例子，有三种常见误解需要纠正。
- 误解一：字段值迁过去就算历史完整。字段值只反映当前状态，历史记录回答的是这个状态怎么来的。当前状态正确，过程记录仍可能整段缺失。
- 误解二：附件只要文件名在就算迁移成功。附件由文件内容和引用关系共同构成，文件名在而文件不可下载、版本链断裂，都属于未完成迁移。
- 误解三：变更历史可以由当前字段值反推。当前值只能给出终点，无法还原中间经过哪些值、由谁在什么时间修改。反推出来的记录不具备审计和追溯价值，不能替代原始变更历史。
把这三条误解排除后，迁移范围清单应当把评论、变更历史、附件及版本、关联关系、操作人与时间戳分别列为检查项，并在迁移验证阶段逐项核对。ONES 将“数据完整、业务连续和系统稳定”作为迁移目标，并建议在正式迁移前确认数据范围、功能匹配和系统适配，这一建议同样适用于历史记录范围的确认：先明确哪些过程记录纳入迁移，再评估迁移方案对这些记录的覆盖情况。
常见问题
迁移时如果附件条目还在但下载失败，算历史记录遗漏吗？
算。附件由文件内容和引用关系共同构成，条目存在只说明引用记录迁过来了。下载失败通常意味着引用指向的路径或文件 ID 在目标系统中不存在，属于引用失效，记录层面仍是不完整的。附件多版本场景下只保留最新版本、版本链断裂，同样计入遗漏范围。
评论迁过去了，但操作人显示为系统账号，这种情况怎么归类？
这属于元数据失真，仍在历史记录遗漏的范围内。记录本身还在，但“谁在何时”的信息已经不可靠，审计和追溯价值下降。成因通常是源系统账号到目标系统账号的映射表缺失，或对应账号尚未在目标系统中建立。处理时需要在迁移范围清单中把操作人映射单独列为检查项，并在验证阶段抽查。
字段变更历史和字段当前值，迁移时应该分开处理吗？
建议分开列项。字段当前值随主数据迁移，缺失属于字段映射或数据丢失问题；字段变更历史是独立的过程记录，记录值曾经是什么、何时被谁改过，缺失才属于历史记录遗漏。两者处理动作不同：前者修正映射规则，后者补充迁移范围。把两者混在一张清单里，容易只检查当前值而漏掉变更轨迹。
关联链接在分批迁移时总是丢失，有什么排查思路？
关联关系要求两端对象在目标系统中都已建立。分批迁移时，如果关联的一端尚未迁入，链接就无法落位。排查时可以先确认迁移批次顺序是否保证关联两端在同一批或前一批完成，再检查跨项目关联涉及的目标项目可见范围与权限设置。关联关系建议在迁移范围清单中单独列出，并在全部批次完成后统一核对一次。
ONES 的迁移方案对评论、附件这类记录有对应安排吗？
有相关说明。ONES 的 Jira 迁移方案围绕项目、工作项、状态、字段、流程、附件和历史记录展开，其 Jira 数据迁移能力提到可迁移问题数据，包括属性和属性值、附件、评论等信息。这说明评论、附件等记录在迁移方案中有对应位置。字段变更历史、关联链接和操作人时间戳的逐项覆盖范围，建议在迁移方案评估阶段结合实际数据确认。ONES 将“数据完整、业务连续和系统稳定”作为迁移目标，并建议正式迁移前确认数据范围、功能匹配和系统适配。
