Jira 账号映射是替换迁移中的独立准备阶段：把源 Jira 的用户账号、组、项目角色及相关权限对象，按可追溯规则对应到目标系统，并用试迁移核验登录、通知、经办人归属和历史记录显示。本文给出盘点、匹配键、映射表、核验与回退条件，适用于迁移目标已确定、进入实施准备的团队。
要点总览（TL;DR）
- 账号映射的范围是 Jira 用户账号、用户组、项目角色及相关权限对象，与问题数据全量迁移分开管理。
- 匹配键以邮箱为主、用户名或工号为辅；同名、多账号、邮箱变更、离职账号一律进入人工确认，不自动合并或新建。
- 映射表至少包含源账号标识、源邮箱、源显示名、源组与项目角色、目标账号、目标组与角色、匹配依据、映射状态和备注，并按版本冻结。
- 试迁移抽样覆盖管理员、普通成员、外部协作账号和停用账号，核验登录、通知接收、经办人归属、历史记录显示和权限范围。
- 关键账号无法匹配或权限错配时暂停切换，回到映射表修正并重新冻结版本，切换前保留源 Jira 账号可用窗口。
Jira 账号映射的范围：映射哪些对象
账号映射的源对象是 Jira 中的用户账号、用户组、项目角色，以及依附于这些对象的权限配置。目标对象是目标系统的成员账号、用户组、角色与权限对象。映射要回答的是“源系统中的这个人和这组权限，在目标系统中对应谁、对应哪个权限对象”，而不是“源系统中的这条数据如何改写”。
从 Jira 迁移到 ONES 时，迁移范围包括用户、用户组和 Jira 系统配置，项目、系统配置中的问题类型、工作流、字段配置、权限配置等也在迁移范围内。账号映射需要先把人员与权限对象的对应关系定下来，后续的问题数据迁移才能正确落到经办人、报告人等人员字段上。
本阶段的范围边界需要提前写清楚，避免与全量迁移混在一起：
- 纳入本阶段：用户账号清单、邮箱与显示名、用户组归属、项目角色成员、与账号相关的权限对象、停用与外部协作账号的处理决定。
- 不在本阶段：问题数据、附件、评论的全量迁移，工作流与字段配置的重构，目标系统内新的权限体系设计。
- 交接物：一份账号映射对象清单，标明哪些对象已纳入、哪些对象由后续阶段处理、哪些对象确认不迁移。
范围说明建议由项目负责人确认后冻结一版。后续如果业务方提出新增映射对象，走变更记录，避免映射表在试迁移前反复扩张。
映射前要准备哪些输入
账号映射的输入分三类：源侧数据、目标侧规则、人员分工。三类输入齐备后再开始填表，可以减少返工。缺少某一类输入时，先标记为待确认，不凭经验补全。
源侧数据
- Jira 用户清单：账号标识、邮箱、显示名、账号状态。
- 用户组清单及成员关系。
- 项目角色成员清单，按项目导出。
- 与账号相关的权限对象清单，例如项目权限方案中引用的人员与组。
目标侧规则
- 目标系统的账号创建规则：由目录同步、手工创建还是批量导入。
- 命名规范：邮箱作为登录名还是独立用户名，显示名格式是否有统一要求。
- 用户组与角色的对应约定：源 Jira 的组如何落到目标系统的组或角色上。
- 停用账号、外部协作账号、服务账号的处理约定。服务账号通常不按人员映射，需要单独列出并确认归属。
责任分工
| 角色 | 负责内容 | 确认节点 |
|---|---|---|
| 业务方负责人 | 确认人员归属、外部协作账号是否保留、离职人员历史记录如何处理 | 映射表初稿完成后 |
| IT 管理员 | 提供源数据导出、执行目标账号创建、处理目录同步问题 | 试迁移前 |
| 迁移实施负责人 | 维护映射表、组织试迁移、记录核验结果 | 每个阶段节点 |
如果源数据导出缺少邮箱字段，或目标侧命名规范尚未确定，应把对应条目放入待确认队列，先完成可确定部分的映射，不因个别字段阻塞整张表。
账号匹配键与冲突处理规则
匹配键决定两个账号是否被视为同一个人。常用做法是以邮箱为主匹配键，以用户名或工号作为辅助校验。邮箱在企业目录中通常唯一且稳定，适合作为第一匹配依据；用户名和工号用于在邮箱缺失或变更时提供第二证据。
匹配键的选择要写成规则，而不是留给填表人临场判断。以下决策表可作为起点：
| 情形 | 处理规则 | 映射状态 |
|---|---|---|
| 邮箱唯一且与目标账号一致 | 直接匹配，记录匹配依据 | 已匹配 |
| 同名不同人 | 不以显示名匹配，改用邮箱或工号区分，两人分别建行 | 已匹配或待确认 |
| 一人多账号 | 确认主账号，其余账号标记为合并或停用，历史记录归属到主账号 | 待确认 |
| 邮箱已变更 | 用旧邮箱加用户名或工号交叉验证，确认后更新目标邮箱 | 待确认 |
| 离职或停用账号 | 按业务方约定选择保留为停用账号、映射到继承人或标记不迁移 | 已停用或不迁移 |
| 外部协作账号 | 确认是否继续协作，保留则单独创建并限制权限范围 | 待确认 |
| 无法匹配 | 挂起，进入人工确认队列，不自动创建新账号 | 待匹配 |
冲突处理的核心原则是不自动合并、不自动新建。同名、多账号、邮箱重复这类情况一旦自动处理，错误会进入历史记录，后续修正成本更高。人工确认队列应指定固定负责人和确认时限，避免挂起项在切换前集中爆发。
离职与停用账号需要业务方明确一个判断：历史工作项上的经办人是否需要在目标系统中仍然可见。如果需要保留可追溯性，通常保留停用账号并映射历史归属；如果业务上允许归并，则记录归并规则和确认人。
映射表怎么建：字段与填写示例
映射表是账号映射阶段的核心交付物，建议用表格工具维护，一行对应一个源账号或一个源权限对象。字段设计要能支撑匹配、核验和回溯三件事。
| 字段 | 说明 | 是否必填 |
|---|---|---|
| 源账号标识 | Jira 中的用户名或账号 ID | 必填 |
| 源邮箱 | Jira 中登记的邮箱 | 必填 |
| 源显示名 | Jira 中显示的名称 | 必填 |
| 源组与项目角色 | 该账号所属的组和项目角色，多个用分号分隔 | 必填 |
| 目标账号 | 目标系统中的账号标识或邮箱 | 已匹配时必填 |
| 目标组与角色 | 对应到目标系统的组或角色 | 已匹配时必填 |
| 匹配依据 | 邮箱、工号或人工确认，注明证据 | 必填 |
| 映射状态 | 待匹配、已匹配、待确认、已停用、不迁移 | 必填 |
| 备注 | 冲突说明、确认人、确认时间 | 选填但建议填写 |
状态流转建议保持单向可追溯：待匹配经人工确认后转为已匹配或待确认；待确认经业务方确认后转为已匹配、已停用或不迁移；已匹配在试迁移发现问题时可回退为待确认，并在备注中记录原因。每次状态变更保留修改人和时间。
一条完整填写示例：源账号标识为 zhangsan，源邮箱为 zhangsan@example.com，源显示名为张三，源组与项目角色为 dev-team、项目 A 开发角色；目标账号为 zhangsan@example.com，目标组与角色为研发组、项目 A 成员；匹配依据为邮箱一致并经 IT 确认；映射状态为已匹配；备注为“2026-01-10 由 IT 管理员确认”。
映射表需要版本记录。建议每次试迁移前冻结一版，文件名带日期，变更走备注或独立变更页。这样在核验出现问题时，能定位到具体是哪一版映射导致的差异。
在目标侧维护成员、组与角色时，ONES 提供企业级账号目录 ONES Account，并可与迁移服务组合使用。映射表定稿后，目标账号的创建和组、角色归属可以按表批量处理，减少逐条手工配置带来的偏差；具体账号目录的配置方式以产品文档或实施确认为准。
试迁移与核验证据
映射表填完不等于映射正确。试迁移的作用是用少量账号验证映射结果，并把问题回写到映射表。抽样应覆盖四类账号：管理员、普通成员、外部协作账号、停用账号。每类至少取一个样本，管理员样本优先选择权限范围较大的账号。
核验项按可观察的证据设计：
| 核验项 | 检查内容 | 通过标准 |
|---|---|---|
| 登录 | 样本账号能否登录目标系统，登录名与映射表一致 | 登录成功且身份正确 |
| 通知接收 | 触发一条工作项变更，确认通知到达正确的人 | 通知收件人与映射表一致 |
| 经办人归属 | 抽查迁移后工作项的经办人、报告人 | 人员归属与源系统一致或符合已确认的归并规则 |
| 历史记录显示 | 查看评论、变更历史中的人员显示 | 显示为映射后的账号，停用账号按约定呈现 |
| 权限范围 | 用样本账号访问项目，确认可见范围与角色一致 | 无越权可见，无应见不可见 |
核验记录建议逐项填写“样本、预期、实际、结论、回写映射表条目”。未通过项分两类处理：映射表填写错误，回到映射表修正后重新抽样；目标系统配置问题，记录后由 IT 管理员处理，不通过在目标系统中临时手工补权限来绕过。试迁移通过的标准可以定为：四类样本全部完成核验，未通过项均有明确处理结论，映射表冻结版本与试迁移版本一致。
回退与停止条件
账号映射阶段需要预设暂停和回退条件，避免问题带到切换当天。以下情况建议暂停推进：关键管理员账号无法匹配；项目角色成员在目标系统中出现权限错配；停用账号的历史归属规则尚未经业务方确认；试迁移中登录或通知核验出现批量失败。
出现上述情况时，处置方式是回到映射表修正，而不是在目标系统中直接手工调整权限后继续切换。手工补权限会让映射表与实际配置脱节，后续核验失去依据。修正后重新冻结映射表版本，再执行一轮抽样核验。
切换前应保留源 Jira 账号可用的时间窗口，窗口长度由业务方和 IT 共同确认，用于处理切换后发现的账号归属问题。确认节点建议设为三个：映射表初稿确认、试迁移核验通过、切换前最终冻结。每个节点指定确认人，确认记录随映射表归档。
从 Jira 迁移到 ONES 的方案建议把迁移工具、原厂服务和分阶段切换结合起来，在正式迁移前确认数据范围、功能匹配和系统适配。账号映射作为其中一项准备工作，按上述节点推进，可以把人员与权限的对应关系在切换前固定下来，为后续问题数据迁移提供稳定的人员归属基础。
常见问题
Jira 账号映射和字段映射、问题数据迁移应该怎么排先后？
账号映射属于人员与权限对象的对应关系，建议先于问题数据迁移完成。问题数据中的经办人、报告人等人员字段依赖账号映射结果，映射表未冻结就迁移问题数据，容易出现人员归属错位后再返工。
字段映射和流程迁移可以与账号映射并行准备，但试迁移核验时三者需要同时到位，才能判断经办人归属和历史记录显示是否正确。建议把账号映射表冻结作为问题数据迁移的前置条件之一。
源 Jira 导出缺少邮箱字段，还能做账号映射吗？
可以继续，但需要调整匹配策略。缺少邮箱时，用用户名或工号作为主匹配依据，并补充其他证据，例如所属组、项目角色、显示名，交叉确认后再标记为已匹配。
无法通过现有字段确认的账号放入待确认队列，由业务方或 IT 管理员人工确认，不凭显示名直接匹配。缺少邮箱的账号在映射表中备注缺失原因，便于试迁移时优先抽样核验。
外部协作账号和服务账号在映射时要注意什么？
外部协作账号需要业务方先确认是否继续协作：保留的账号单独创建并限制权限范围，不并入内部人员账号；不再协作的账号标记为不迁移，并在备注中记录确认人。
服务账号通常不对应具体人员，建议单独列出清单，确认其用途和归属责任人，再决定映射到目标系统的哪个账号或直接停用。两类账号都不适合按普通成员规则批量处理。
试迁移核验发现问题，应该改映射表还是直接在目标系统里调整？
先判断问题来源。映射表填写错误，回到映射表修正并重新冻结版本；目标系统配置问题，记录后由 IT 管理员处理。直接在目标系统中手工补权限会让映射表与实际配置脱节，后续核验失去依据。
修正后重新抽样核验，并在映射表备注中记录问题、处理方式和确认人。试迁移通过的标准建议定为：四类样本全部完成核验，未通过项均有明确处理结论，映射表冻结版本与试迁移版本一致。
从 Jira 迁移到 ONES 时，账号目录和映射表如何衔接？
ONES 方案提供 ONES Account 企业级账号目录，并可与迁移服务组合使用。实际操作中，映射表定稿后再按表创建目标账号、配置组与角色归属，可以减少逐条手工配置带来的偏差。
账号目录的具体配置方式、命名规范和外部账号管理能力，以产品文档或实施确认为准。迁移前建议与实施方确认数据范围、功能匹配和系统适配，账号映射作为其中一项准备工作同步推进。
