新旧系统权限平滑过渡的完整路径：解耦、映射、双轨、回滚

聊起系统替换，很多技术负责人第一反应不是新系统多强大，而是旧系统的权限怎么搬过来。

更直白地说：怎么在用户无感知的前提下，把权限从老架构切到新架构？中间不能出现“早上能审批、下午点不动”的真空期，也不能出现“离职员工还能进财务系统”的安全漏洞。

一、核心难点：为什么权限过渡比数据迁移更棘手？

数据迁移可以离线做、可以批量跑、错了还能回滚。但权限是实时生效的控制指令，它的特殊性在于三点：

1. 状态依赖：权限和用户身份、组织架构、岗位角色强绑定，而这些东西业务每分每秒都在变
2. 系统异构：自研系统的RBAC模型、SAP的权限代码、OA的岗位赋权……彼此完全不认识
3. 审计要求：替换过程必须有日志，说不清楚“谁在什么时候获得了什么权限”，合规直接挂科

传统做法是“双写+人工核对”，但经验告诉我：人工核对在异构系统面前基本无效——你永远不知道哪个系统的权限映射漏了一条。

二、三层递进策略：从“不中断”到“可回滚”

我把它总结为观察层→映射层→执行层的过渡模型。

第一层：建立统一的权限观测视图

替换之前，先搞清楚现状。不是去翻文档，而是做一件事：

把现有系统的权限关系拉平成一个清单。

具体操作：

• 从HR系统导出组织架构和人员状态
• 从各业务系统导出当前的有效权限（不是角色名，是实际生效的权限位）
• 建立一张“人—岗位—系统权限”的关联表

这一步不需要动任何系统，只做数据采集和清洗。目的只有一个：知道现在的真实状态是什么，而不是“文档里写的应该是什么”。

我常用的做法是先通过平台的统一身份模块对接HR系统的权威源，把“唯一事实来源”先定下来。人对了，权限才不会跑偏。

第二层：构建解耦的角色映射模型

这是最核心的一步。

不要在旧系统里改，也不要在新系统里猜。而是在中间建一个独立的角色映射层。

举个例子：

• 旧系统中“财务审批岗”的权限是：SAP的Z_FI_APP + OA的报销审核 + 自研系统的role_finance_approve
• 新系统中“财务审批岗”的权限是：新ERP的FIN_APPROVE + 新OA的EXPENSE_CHECK

如果直接搬，你会陷入“一个角色对多个系统、多个权限代码”的泥潭。

正确做法：定义业务角色，比如“财务审批主管”。这个角色不依赖任何系统的技术实现，然后单独维护两张映射表：

• 业务角色 → 旧系统权限集合
• 业务角色 → 新系统权限集合

这样替换时，换的是映射关系，不是用户的角色。用户始终是“财务审批主管”，只是底层指向的目标变了。

在实施过程中，我反复验证了这个逻辑的有效性。平台的角色建模模块支持多维属性组合，比如“华东区+财务主管+职级P7”这种复合条件，拆解后自动映射到不同系统的具体权限代码。最终的效果是：业务方看到的角色没变，IT侧手里的技术实现已经换了一套。

第三层：灰度切换 + 双轨执行

技术方案再好，也不敢一次性全切。

我的习惯做法：

阶段一：读旧写新

• 权限校验仍走旧系统
• 所有变更操作同时写入新旧两个系统
• 持续观察新系统的权限计算结果，但不启用

阶段二：读新写新（旧系统旁路）

• 权限校验切换到新系统
• 旧系统仍然同步接收变更，保持热备
• 运行至少一个完整业务周期（比如一周）

阶段三：停旧归档

• 关闭旧系统的权限写入通道
• 保留只读查询能力和日志，用于审计追溯

这个策略的关键不是技术多复杂，而是给了业务方一个明确的回滚窗口。出了任何异常，5分钟内切回旧系统，业务不停。

三、最容易翻车的三个细节

经验告诉我，大方向对了，翻车往往在细节上。

细节1：增量同步的时机

离职员工权限回收，拖一小时都是风险。

不要用定时任务每小时跑一次，要事件驱动。HR系统做离职操作那一刻，立刻触发权限回收指令。有一个客户就是这样的，我们开始接触的时候，他们内部有一个真实案例：某员工离职三天后，还能在旧系统里导出客户报价单。原因是三个系统的回收脚本执行时间不一致。后来改用统一权限中枢的事件触发机制，延迟控制在秒级。

细节2：字段映射的默认值陷阱

不同系统对“空值”的处理完全不同。

旧系统里department=NULL表示“不限制部门”，但新系统里NULL可能被解析为“无任何部门权限”，结果就是用户登陆后一片空白。

解决办法：显式映射所有边界值。不要依赖系统的默认行为，把NULL、空字符串、0、-1这些特殊值在映射逻辑里明确写出来。

细节3：审计日志的关联字段

过渡期间最怕审计追问：“这条权限变更，对应的工单号是多少？”

新旧系统可能用不同的流水号规则。我的做法是在中间层维护一个全局变更ID，一次权限申请产生一个ID，贯穿所有系统的执行记录。这样审计时搜一个ID，能看到完整链路。

四、总结：三个核心原则

如果要我提炼成三句话：

1. 先定身份，再管权限——人员主数据不乱，权限过渡就成功了一半
2. 业务角色恒定，技术映射可换——别让用户感知到底层系统变了
3. 灰度切、双轨跑、随时回滚——技术要为业务留退路

最后说一句：现在很多技术负责人还在用Excel管理权限映射，不是不能做，而是当系统数量超过5个、用户超过500人之后，Excel的版本混乱和人工失误会直接变成安全事件。

工具不是万能的，但结构化的方法一定比“人肉运维”可靠。如果你也在经历类似的权限过渡阵痛，不妨先画一张“人—角色—系统权限”的拓扑图，问题往往就暴露在连线交叉的地方。