发生了什么
商户端 App 是商户管理自己员工和权限的工具:管理员在这里给员工勾选“渠道数据权限”,决定这名员工登录后能看到、能操作哪些商户和门店的数据。权限项本身由权限服务维护,是一棵按功能分层的菜单树,每个节点对应一个页面或一项操作;商户中台则保存商户档案和每家商户的数据范围。正常流程是:管理员打开分配页,商户端 App 向权限服务请求“这名员工可分配的权限项”,权限服务按该账号所属商户的数据范围裁剪,只返回这家商户能分配的节点;管理员勾选保存后,员工登录才看得到对应范围的数据。
这次的现象是:管理员打开分配页,勾选列表一直是空的,换账号试、退出重进、刷新几次都一样,持续好几天。列表里没有任何可勾的权限项,“保存”也就无从谈起,员工始终拿不到渠道数据权限,看不到自己该看的商户数据。
本质
一句话:查权限项的请求没有带任何范围条件,服务端便把整个换电商户服务的全量菜单树返回,页面始终等不到可用的节点。
- 商户端 App 打开分配页时,向权限服务请求菜单树。这次请求只带了业务服务名(决定查哪一块业务的权限项)和员工账号,没有带“这名员工属于哪家商户、这家商户的数据范围是什么”。账号虽然传了,接口却没有用它参与过滤。
- 权限服务按服务维度查菜单树,没有范围条件就无从裁剪,于是把这一个服务下所有商户的菜单树整棵取出并返回。返回内容覆盖全部商户,不再是这家商户那几十个可分配的节点。
- 页面拿到全量树后,还要自己从中挑出属于当前商户的节点再渲染成勾选清单。节点数量随商户规模增长,这一次已经超出请求能正常完成的范围——无论是卡在接口返回太久,还是返回体大到页面渲染不出来,表现都一样:列表是空的。
- 管理员重试、刷新,只是把同一个不带范围的请求再发一次,返回的还是整棵树,所以几天都不会自己好。这期间该商户与员工之间的权限关系没有写入,员工登录后自然没有对应的数据范围。
范围条件必须跟着请求一起下推到查询:只传业务维度,服务端就只能按全量返回,权限分配能不能用就被商户数量决定。
修复方向是三处一起改:商户端 App 传商户账号标识;权限服务查询时按该账号关联出所属商户的数据范围,在服务端裁掉范围外的菜单分支;商户中台提供按账号取数据范围的接口。只要中间有一方仍按全量返回,页面还是会收到整棵树,只改前端在页面里做筛选解决不了问题。目前没有看到修复上线后的验证结论,是否已在线上生效待确认。
错误代码
// 商户端 App:打开“给员工分配权限”页面,先拉可分配的权限项
String url = "/menu/tree?service=" + service + "&accountId=" + accountId;
// 为什么错:service 只说明查哪块业务的权限项,账号虽然带上了,
// 但服务端并不用它过滤,页面拿到的仍是全量树
List<MenuNode> nodes = http.get(url, MenuNode.class);
// 权限服务:菜单树查询接口
@GetMapping("/menu/tree")
public List<MenuNode> tree(@RequestParam String service,
@RequestParam Long accountId) {
// 为什么错:只按服务维度取,等于把这个服务下所有商户的菜单树
// 整棵返回;accountId 收了却没有参与裁剪
return menuMapper.selectAllByService(service);
}
修复代码示例
// 商户端 App:调用方式不变,账号照旧传
List<MenuNode> nodes = http.get("/menu/tree?service=" + service
+ "&accountId=" + accountId, MenuNode.class);
// 为什么这样改:页面直接拿到本账号可分配的权限项,
// 不再需要在全量树里自己筛
// 权限服务:把范围条件下推到查询
@GetMapping("/menu/tree")
public List<MenuNode> tree(@RequestParam String service,
@RequestParam Long accountId) {
MerchantScope scope = merchantScopeService.loadByAccount(accountId);
if (scope.isEmpty()) {
return List.of(); // 没有范围就返回空,绝不退回全量
}
List<MenuNode> rows = menuMapper.selectByServiceAndScope(
service, scope.getMerchantIds()); // 只查范围内的节点
return MenuTreeAssembler.trim(rows, scope); // 范围外的整棵分支裁掉
}
下次遇到这些场景要警惕
- 给“分配权限”“配置可见范围”这类页面提供数据源时:用小范围和大范围两个账号各请求一次,比较返回的节点数是否随范围变化;两个账号返回一样多,说明范围条件根本没有生效。
- 新增按业务服务或租户维度查树的接口:用两家商户的账号分别请求,检查返回里有没有混入对方商户的节点;当前商户能正常显示,不足以说明别人的分支被裁掉了。
- 收到“刷新也不出来”的反馈时:先确认刷新是否只是重发同一个请求,再把请求参数和返回体积一起记下来,别把必然失败当成偶发波动。
- 权限项来源跨多个系统时:改任一处都按“请求带范围 → 服务端裁剪 → 保存后员工登录可见”整条链路回归一遍,不要只验证列表能显示出来。