Jira 账号映射的目标，是让源端每个账号在目标系统中对应到一个可登录、可归属工作的账号，并让历史记录里的经办人、报告人、评论作者和工时记录人继续落到正确的人名下。做法可以拆成四步：盘点源端账号与使用痕迹、确定目标端账号来源与命名规则、按匹配优先级建立映射表、用试迁移样本校验归属。下面按阶段说明每一步的输入、产物和判断标准。
要点总览（TL;DR）
- Jira 账号映射分四步：盘点源端账号与使用痕迹、确定目标端账号来源与唯一标识、按匹配优先级建立映射表、用试迁移样本校验归属。
- 匹配按唯一邮箱精确匹配、工号或目录 ID 匹配、显示名辅助匹配、人工确认逐级降级；同名不同人、一人多账号、离职账号、外部协作账号单列规则，不直接丢弃或合并。
- 映射表至少保留源账号唯一标识、目标账号、匹配依据、映射状态和异常备注，并做版本留痕，试迁移后的修正通过新增版本完成。
- 试迁移样本覆盖活跃、停用、外部和同名风险账号，校验经办人、报告人、评论作者、工时记录人的归属，通过标准在试迁移前定好。
- 目标端账号批量缺失、邮箱唯一性无法保证、同名账号无法区分时先暂停，以映射表版本为基础回退重跑。
映射范围：先确认源端账号与目标端账号边界
账号映射开始前，先写一份范围说明，明确本次纳入哪些 Jira 用户、对应目标系统的哪类账号，以及映射结果要覆盖哪些字段引用。范围不清时，后续导出和匹配容易把项目数据映射、权限配置迁移混进来，导致映射表反复返工。
源端范围建议按账号状态分三类盘点：活跃账号、已停用账号、仅出现在历史记录中的账号。活跃账号是映射主体；已停用账号影响历史经办人和评论作者的归属；只在历史记录里出现、用户目录中已不存在的账号，需要单独列出，确认迁移后是否保留占位账号或归并到交接人。三类账号的处理口径应在范围说明中写清楚。
目标端范围取决于目标系统的账号来源：本地账号、企业目录同步或单点登录。不同来源决定了唯一标识用什么——本地账号可能以邮箱或用户名为准，目录同步通常有目录 ID，单点登录则以身份提供方的账号标识为准。映射前要向目标系统管理员确认账号创建方式和唯一标识字段。
映射对象包括账号本身，以及账号在经办人、报告人、评论作者、工时记录等字段中的引用。权限方案、项目角色授权、工作流配置属于另外的迁移环节，不放进账号映射表，但可以在范围说明中标注“另行处理”，避免遗漏。
本阶段的交付物是一份账号映射范围说明，至少列明：纳入的账号类别及数量、排除的账号类别及原因、需要校验归属的字段清单、目标端账号来源与唯一标识。
本阶段输入与依赖：导出哪些账号数据
映射的可靠性取决于输入数据是否完整。开始匹配前，需要把源端账号清单、使用痕迹数据和目标端账号清单放在一起核对，并明确每项数据由谁提供。
从 Jira 导出的用户清单，建议包含以下字段：用户名（账号唯一标识）、邮箱、显示名、账号状态（活跃或停用）、所属用户组。用户名是源端最稳定的标识，邮箱用于跨系统匹配，显示名只作辅助，用户组有助于判断账号的业务归属和后续人工确认的分组。
仅有用户清单还不够，还要知道每个账号在业务数据中的出现情况：作为经办人、报告人、评论作者、工时记录人分别出现在哪些项目和历史记录中。使用痕迹数据决定了哪些账号必须优先映射、哪些账号可以进入低优先级人工确认。导出时按项目或时间范围分批，便于后续抽样校验时定位样本。
目标端需要准备账号清单及唯一标识，字段至少包括目标账号、邮箱、工号或目录 ID、账号状态。目标账号清单应在映射开始前完成同步，避免映射过程中人员目录变动导致匹配结果失效。
依赖方通常包括：IT 或 HR 提供人员目录和在职状态，Jira 管理员提供用户导出权限和使用痕迹数据，目标系统管理员确认账号创建方式、命名规则和唯一标识。建议把数据项、提供方、交付时间和确认人列成一张准备清单，作为映射启动的前置条件。
映射方法：匹配规则、映射表结构与人工确认
匹配按优先级逐级降级，能自动匹配的走规则，不能匹配的进入人工确认清单，不直接丢弃或合并。推荐的顺序是：唯一邮箱精确匹配、工号或目录 ID 匹配、显示名辅助匹配、人工确认。邮箱匹配要求源端和目标端邮箱都唯一；出现一个邮箱对应多个账号时，不能自动通过，应转入人工确认。
映射表是这一阶段的核心产物，字段设计要能支撑匹配、复核和回溯。可参考下表：
| 字段 | 说明 | 示例 |
|---|---|---|
| 源账号唯一标识 | Jira 用户名，作为源端主键 | zhangsan |
| 源显示名 | Jira 中的显示名，仅辅助识别 | 张三 |
| 源邮箱 | 用于跨系统匹配 | zhangsan@example.com |
| 目标账号 | 目标系统中的登录账号 | zhangsan@corp.example.com |
| 目标唯一标识 | 邮箱、工号或目录 ID | E10086 |
| 匹配依据 | 邮箱精确、工号、显示名辅助、人工确认 | 邮箱精确 |
| 映射状态 | 已匹配、待确认、不迁移、已合并 | 已匹配 |
| 异常备注 | 同名、多账号、离职、外部协作等说明 | 与另一账号同名，已人工区分 |
几类特殊账号需要单列规则。同名不同人：显示名相同但邮箱或工号不同，按邮箱或工号区分，禁止仅凭显示名自动合并。一人多账号：同一自然人在 Jira 中有多个账号，先确认哪个是主账号，其余账号标记为合并到主账号，并在备注中记录原账号，保证历史记录可追溯。离职账号：确认其历史工作由谁接手，映射到交接人账号或保留停用占位账号，具体口径与业务负责人确认。外部协作账号：供应商、客户等外部人员，确认目标系统是否允许创建外部账号，不允许时映射到内部对接人并备注。
映射表要纳入版本管理。每次批量修改前保存上一版，记录修改人、修改时间和修改原因。试迁移后发现的错配，通过新增版本修正，不直接覆盖旧记录，便于对照和回退。
如果目标系统是 ONES，账号映射可以和成员目录、工作项归属的管理动作衔接起来。ONES 的 Jira 迁移范围包括用户、用户组和系统配置，问题数据中的属性、评论等信息也在迁移范围内；ONES Account 作为企业级账号目录模块，可与迁移方案中的其他模块组合使用。映射表维护完成后，可在目标端核对成员是否已建立、工作项经办人与评论作者是否指向预期成员。具体的自动匹配规则、映射表导入导出方式，以及 ONES Account 与目录同步或单点登录的对接前提，建议在实施前向原厂确认，并以实际迁移方案为准。
试迁移校验：用样本验证账号归属是否正确
正式切换前，用一小批样本数据做试迁移，验证映射结果。样本要覆盖四类账号：活跃账号、停用账号、外部账号、存在同名风险的账号。每类至少选几个，确保规则在边界情况下也成立。
校验点集中在账号引用的字段上：工作项的经办人是否落到预期账号，报告人是否正确，评论作者是否保留原归属，工时记录人是否对应到正确成员。校验时以映射表为基准，逐条比对迁移前后的记录，发现不一致就记录到异常清单。
校验证据建议保留三类：迁移前后对照记录（源账号、目标账号、字段、迁移前值、迁移后值）、异常清单（问题描述、涉及账号、处理状态）、修正后的映射表版本号。对照记录不必覆盖全部数据，但要能说明样本范围内每个校验点的结果。
通过标准在试迁移前就要定好，例如：样本内经办人、报告人、评论作者、工时记录人的归属一致率达到约定比例，异常项全部有处理结论。未通过时，回到映射表修正匹配规则或人工确认结果，重新导出样本再跑一轮，不带着已知错配进入正式迁移。
回退与停止条件：哪些情况先暂停映射
映射过程中出现以下情况，建议暂停并先解决问题：目标端账号批量缺失，说明目录同步或账号创建环节未完成；邮箱唯一性无法保证，自动匹配会产生歧义；同名账号无法区分，人工确认缺少足够依据。暂停不是终止，而是把问题收敛到可处理的范围后再继续。
回退方式以映射表版本为基础：保留上一版映射表，试迁移产生的数据可清理后按旧版本重跑。每次回退记录触发原因、回退版本和重新执行的时间，避免同一问题反复出现。
切换前需要关闭的异常项应逐条确认，包括待确认账号全部有结论、合并账号有备注、离职账号有交接人、外部账号有处理方式。每类异常指定确认人，确认人签字或书面确认后才进入正式切换。
切换后短期观察登录失败反馈和责任人错配反馈。登录失败通常指向账号未创建或标识不一致，责任人错配指向映射表匹配依据有误。两类反馈都应能追溯到映射表中的具体记录，便于快速修正。账号映射的质量最终体现在历史记录的责任人归属是否连续，试迁移校验和切换后观察都是为这一点提供证据。
常见问题
Jira 里已经停用的账号，迁移时还需要映射吗？
需要单独处理。停用账号通常仍出现在历史工作项的经办人、评论作者等记录中，直接丢弃会让历史归属断档。建议在范围说明中把停用账号单列一类，确认其历史工作由谁接手：映射到交接人账号，或保留停用占位账号。具体采用哪种口径，与业务负责人确认后再写入映射表。
源端和目标端邮箱不一致时，还能自动匹配吗？
邮箱不一致时，唯一邮箱精确匹配这一级不成立，需要降级到工号或目录 ID 匹配。如果目标端账号清单里有工号或目录 ID，且源端能提供对应字段，可以按该标识匹配；两者都没有时，只能进入人工确认清单，由熟悉人员情况的人逐条确认。显示名只作辅助识别，不建议作为自动匹配依据。
映射表做好后，正式迁移前还要做哪些确认？
先完成试迁移校验，确认样本范围内经办人、报告人、评论作者、工时记录人的归属与映射表一致，异常项都有处理结论。切换前逐条关闭异常：待确认账号有结论、合并账号有备注、离职账号有交接人、外部账号有处理方式，并由指定确认人书面确认。目标端账号清单也要在切换前再同步一次，避免人员目录变动导致匹配失效。
目标系统是 ONES 时，账号映射环节可以借助哪些模块？
ONES 的 Jira 迁移范围包括用户、用户组和系统配置，问题数据中的属性、评论等信息也在迁移范围内；ONES Account 作为企业级账号目录模块，可与迁移方案中的其他模块组合使用。映射表维护完成后，可以在目标端核对成员是否已建立、工作项经办人与评论作者是否指向预期成员。自动匹配规则、映射表导入导出方式，以及 ONES Account 与目录同步或单点登录的对接前提，建议在实施前向原厂确认，以实际迁移方案为准。
试迁移发现错配后，是改映射表还是重新导出数据？
先判断错配来源。如果是匹配依据有误，比如同名账号被错误合并或邮箱对应关系写错，修正映射表并新增版本，再重新导出样本跑一轮；如果是源端或目标端账号清单本身不完整，先补齐数据再匹配。两种情况都不建议直接覆盖旧版映射表，保留上一版便于对照和回退。
