Jira 自定义字段迁移可以拆成“定义—取值—使用位置”三层来处理：先盘点字段类型、选项集、上下文和引用位置，再按业务语义建立映射表，区分直接迁移、类型转换、合并和丢弃，随后用小项目试迁移并逐条比对取值，确认后分批切换并保留回退窗口。整个过程的目标是让字段在新系统中继续承载原有业务含义，而非简单把列名搬过去。
要点总览（TL;DR）
- Jira 自定义字段迁移按“定义—取值—使用位置”三层拆解：先盘点字段类型、选项集、上下文，再查清界面、工作流校验、筛选器和报表的引用关系。
- 字段映射依据业务语义而非字段名，处置分为直接映射、类型转换、多字段合并、丢弃归档四类，选项值单独建映射表并处理空值与历史脏数据。
- 先在有代表性的小项目上试迁移，逐条比对字段值、显示格式、必填与默认值、筛选器命中情况，差异回填映射表后再扩大范围。
- 验收看字段覆盖率、取值准确率、选项命中率和校验行为，保留比对记录与导入日志；切换按低风险项目到核心项目分批推进，并保留源系统只读与导出快照作为回退基础。
- 插件生成的字段和计算类字段需逐项评估替代方案，具体字段类型的迁移覆盖范围以目标系统实际版本文档和迁移评估结果为准。
迁移范围：哪些自定义字段要迁、迁到哪里
动手前先写清迁移边界：源系统是哪个 Jira 版本、云版还是数据中心版，目标系统及其版本，本次覆盖哪些项目。字段迁移的复杂度往往来自范围失控，把整个实例的所有字段一次性搬走，会让映射和验证工作量成倍增加。建议以项目群或业务线为单位划定第一批范围。
字段清单的筛选可以按三种口径分类：
- 在用字段：当前项目的工作项界面、工作流校验、筛选器或报表仍在引用，属于必迁范围。
- 历史遗留字段：曾经使用、现已从界面移除，但历史工作项上仍有取值。是否迁移取决于这些历史数据是否还需要查询和统计。
- 仅报表使用字段：不出现在录入界面，只被仪表盘或统计报表引用。迁移时要同步确认目标系统报表能否基于新字段重建。
按类型归类有助于预判转换难度：文本、数值、日期类字段通常映射直接；单选、多选字段的关键在选项集对应；用户选择字段依赖用户目录的对应关系；级联选择字段涉及层级结构；计算类字段需要确认目标系统是否支持同等计算逻辑，还是转为脚本或报表公式。
同时明确本次不迁的对象，例如附件、评论历史、部分插件生成的字段。插件字段尤其需要单独评估，依赖插件的定制逻辑通常无法随标准字段一并迁移，应逐项确认替代方案。最终产出一份字段范围清单，每个字段标注去留、优先级和负责人。
迁移前要准备什么：字段清单、选项集与依赖关系
这一阶段的产出是后续映射和试迁移的输入，准备不充分会在试迁移时集中暴露问题。需要拿到的信息包括：
- 字段定义：字段名称、类型、默认值、是否必填、字段配置方案，以及字段上下文（限定在哪些项目、哪些问题类型上生效）。
- 选项集：单选和多选字段的完整选项列表及选项 ID。选项 ID 是历史数据取值的实际存储形式，只记录选项文字容易在重名或改名的选项上出错。
- 引用关系：字段被哪些界面方案、工作流校验、筛选器、看板、报表引用。一个字段从界面移除但筛选器仍在用，迁移后筛选器会失效，这类依赖必须提前记录。
- 目标系统侧条件：可用的字段类型、字段数量或选项数量限制、必填与校验能力的差异。这部分需以目标系统实际版本文档核对，不同版本和部署形态的支持范围可能不同。
把上述信息整理成字段依赖关系表，同时列出待确认问题清单，例如“某字段在三个项目中同名但选项集不同”“某计算字段的公式依赖插件函数”。这些问题在映射阶段必须有人给出结论，不能留到切换当天处理。
同名字段含义不同时怎么映射
映射的依据是业务语义，字段名只是线索。两个系统里都叫“优先级”的字段，选项可能是“高/中/低”对“P0/P1/P2/P3”，也可能一个用于排期、一个用于缺陷严重程度。做法是先为每个源字段写一句用途说明，说明它记录什么信息、被谁在什么场景下填写和查看，再据此决定处置方式。
字段处置分为四类：
| 处置方式 | 适用情况 | 注意事项 |
|---|---|---|
| 直接映射 | 类型一致、语义一致 | 仍需核对默认值与必填设置 |
| 类型转换 | 语义一致但类型不同，如文本转单选、数值精度不同 | 转换规则要能处理无法转换的取值 |
| 多字段合并 | 源系统多个字段在目标系统由一个字段承载 | 合并规则需业务负责人确认，避免信息丢失 |
| 丢弃并归档 | 字段已无业务用途或目标系统无对应承载 | 导出快照留存，记录丢弃理由 |
选项值映射单独建表，逐项列出旧选项到新选项的对应关系，并显式处理空值和历史脏数据。常见情况包括：选项已停用但历史工作项仍有取值、选项文字存在拼写变体、多选字段的历史值包含已删除选项。这些取值需要有明确的落点，例如归入“其他”选项或保留原文本。
级联选择字段要确认目标系统的层级深度和选项容量是否匹配；用户选择字段依赖账号对应关系，离职用户的历史取值需要决定保留方式；计算字段要确认目标系统是支持公式、需要改用自动化规则，还是只能保留计算结果作为静态值。这些转换点都需要人工确认，不能默认自动完成。
映射表建议包含以下列：源字段、源类型、目标字段、目标类型、转换规则、选项映射说明、负责人、状态。状态用“待确认/已确认/试迁移通过/已切换”推进，让每行都有明确的责任人和进度。
试迁移怎么做：小样本验证字段取值
试迁移的目的是在少量真实数据上验证映射表，把类型和选项问题提前暴露。选取一个有代表性的项目，样本量以覆盖每种字段类型和边界值为准，通常几十到几百条工作项即可，不必追求全量。
执行步骤可以按以下顺序：
- 从源系统导出样本工作项及其字段取值，保留字段 ID 和选项 ID。
- 按映射表转换数据，转换过程保留原始值与转换后值的对照。
- 导入目标系统，记录导入日志和失败条目。
- 抽样比对：字段值是否一致、显示格式是否符合预期、必填与默认值是否生效、原有筛选条件能否在新系统中命中同类结果。
比对时特别关注边界情况：空值字段、多选字段包含多个选项、日期字段的时区处理、数值字段的小数位、用户字段指向已停用账号。发现的差异逐条记录，回填到映射表并修订转换规则，形成“发现—修正—复测”的闭环。试迁移通过的标准是差异记录全部有结论，而非导入过程没有报错。
核验与证据：怎么判断字段迁移成功
导入成功提示只说明数据写入了目标系统，不能说明字段含义被正确保留。验收需要从几个维度分别判断：
- 字段覆盖率：范围清单中的字段是否全部在目标系统存在，丢弃字段是否有归档记录。
- 取值准确率：抽样工作项的字段值与源系统一致的比例，按字段类型分别统计。
- 选项命中率：单选、多选字段的取值是否全部落在目标选项集内，未命中项是否按预定规则处理。
- 校验行为：必填字段在新建和编辑时是否按预期拦截，工作流校验是否生效。
- 引用可用性：依赖该字段的筛选器、看板、报表能否正常返回结果。
抽样比对采用源系统与目标系统并排对照的方式，按字段类型分层抽样，核心字段全量核对。可接受的差异阈值在迁移前约定，例如非核心字段抽样准确率达到约定比例即可通过，核心字段要求全部一致。证据形式包括比对记录表、关键界面截图、导入日志和负责人确认签字，统一归档到固定目录，便于切换后追溯。失败样本按“映射规则错误、源数据脏值、目标系统限制”归类，分别走修订映射、清洗数据或调整方案的返工路径。
分批切换与回退条件
切换按风险从低到高推进：先迁低风险项目验证流程，再迁核心项目。每个批次设置切换窗口，在窗口内冻结源系统的字段结构变更和批量写入，避免迁移过程中数据继续变动导致比对失真。
回退触发条件需要在切换前写清楚，例如：核心字段取值错误率超过约定阈值、关键字段在目标系统缺失、依赖字段的筛选器大面积失效、必填校验行为与预期不符。触发后停止当前批次，回到源系统继续作业，修正映射后重新安排窗口。
回退能力依赖三项准备：源系统在切换后保留只读状态一段时间、切换前保留完整导出快照、映射表按版本留存。这样即使目标系统侧发现问题，也能定位是哪个版本的映射规则导致，并在源数据基础上重新执行。批次计划中为每个批次标注回退检查点，明确谁有权决定回退。
迁移完成后字段体系怎么维护
迁移结束后的字段治理决定了新系统会不会在半年后重现字段泛滥的问题。基本规则包括：字段命名统一规范并附用途说明，避免同名不同义；新增字段走评审入口，由固定责任人判断是否与已有字段重复、是否真的需要新建；定期清理长期无取值的字段，清理前导出数据留存。
字段定义和变更记录需要有承载位置。以 ONES 为例，其 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，并可迁移问题类型、工作流、字段配置、权限配置等系统配置，问题数据中的属性和属性值也在迁移范围内；插件相关的定制场景则建议先梳理实际使用的插件，再逐项评估功能对应方式。迁移完成后，字段的用途说明、映射规则和变更历史可以随项目配置与文档一起维护，让后续调整有据可查。具体字段类型的迁移覆盖范围和转换规则，需以实际版本文档和迁移评估结果为准。
常见问题
Jira 里已经停用但历史工作项仍有取值的字段，迁移时怎么处理？
先判断这些历史取值是否还需要查询和统计。需要保留的，把字段纳入迁移范围，并在选项映射表中为已停用的选项指定落点，例如归入“其他”选项或保留原文本；不再需要的，导出快照留存后按丢弃归档处理，并在范围清单中记录丢弃理由。关键是不要让已停用选项在导入时变成空值而无人察觉。
多个项目里同名字段但选项集不同，能合并成一个字段吗？
可以合并，前提是先确认这些字段记录的是同一类业务信息。做法是逐个项目核对字段用途说明和选项含义，把各项目的选项归并成一套目标选项集，再为每个旧选项建立到新选项的对应关系。如果同名字段实际含义不同，例如一个用于排期优先级、一个用于缺陷严重程度，应拆成两个目标字段分别映射，避免合并后语义混淆。
试迁移要跑多少数据才算够？
样本量以覆盖每种字段类型和边界值为准，通常几十到几百条工作项即可，不必追求全量。选取时要包含空值字段、多选字段含多个选项、日期字段跨时区、数值字段带小数、用户字段指向已停用账号等情况。试迁移通过的标准是差异记录全部有结论，导入过程没有报错只是最低要求。
迁移过程中发现字段取值错误率偏高，应该继续还是回退？
切换前先约定回退触发条件，例如核心字段取值错误率超过阈值、关键字段缺失、依赖字段的筛选器大面积失效。触发后停止当前批次，回到源系统继续作业，修正映射规则后重新安排切换窗口。回退能力依赖三项准备：源系统保留只读状态一段时间、切换前保留完整导出快照、映射表按版本留存，这样能定位是哪个版本的规则出了问题。
依赖 Jira 插件的自定义字段能随标准字段一起迁移吗？
插件字段需要单独评估，不能默认随标准字段一并迁移。建议先梳理实际使用的插件清单，再逐项确认目标系统是否有对应能力承载该字段记录的信息，或者改用其他方式保留。以 ONES 为例，其 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，并可迁移问题类型、工作流、字段配置、权限配置等系统配置；插件相关的定制场景则建议先梳理插件使用情况，再逐项评估功能对应方式，具体覆盖范围以实际版本文档和迁移评估结果为准。
