发生了什么
运维后台里有一个电柜调拨功能,用来把电柜从一个网点挪到另一个网点。一张调拨单要交代两端的位置:调出哪座城市、哪个网点,调入哪座城市、哪个网点。城市不是让运维手输编码,而是从城市选择框里搜出来、再挑这座城市下的网点,两边填完才提交,后面才走进出库流程。
正常情况下,这个城市选择框列出的是业务在运营的所有城市,谁登录看到的都一样。运维输入城市名,候选里能搜到并选中,再往下挑网点,单子就能建出来。
这一次,值班运维在创建调拨单时搜不到要调拨的那座城市。不是字打错,也不是这座城市没有运营:城市候选来自后台一个按登录人取数的接口,这个接口先查「当前登录的运维拥有哪些城市的数据权限」,再把权限内的城市作为列表返回。这个运维没有为这座城市申请过城市权限,日志里查到的权限城市清单不含这座城市,所以候选里就少了它,输入关键词自然也匹配不到。
页面上没有出现「你没有该城市权限」之类的提示,运维看到的只是搜不到。产品确认后认为这不满足业务预期:创建调拨单时运维需要先看到并选择城市,城市选项应当来自业务在运营的城市清单,不应因为某个人没申请权限就消失。于是前端把城市选择框的取数接口,从一个按人过滤的接口换成返回运营城市字典的接口。
本质
一句话:城市选择框要的是「系统里有哪些城市」,它接的却是「我能操作哪些城市」的接口,权限过滤把没申请过权限的城市从候选里删掉了。
拆开看:
- 两个接口回答的不是同一个问题。一个返回运营城市字典:业务在哪些城市有电柜、能做调拨,就返回哪些城市,与登录人无关。另一个返回登录人的城市权限列表:只返回这个人被授权的城市,没申请过的不会出现。前者回答「有哪些」,后者回答「我能动哪些」。
- 选择框取了后者。候选因此等于「运营城市集合」和「这个人的权限集合」的交集。权限集合里没有这座城市,交集里就没有它,搜索只能在这份已经缩小的候选里找,结果必然是搜不到。
- 错不在权限接口本身。按人返回授权范围是它的本职,这个接口本身没有缺陷。错在把一个授权查询挂到了「供人挑选项」的位置上:同一张表单,不同的人看到不同的候选,而产品预期是所有人看到同一份城市字典。
- 这个错误还是静默的。授权为空时接口返回空列表,页面既没有报错,也没有提示去申请权限。运维只能得出「搜不到」这个结论,问题因此以功能故障的形式报到研发,而实际原因是这个账号少了一条城市授权。
权限接口没坏,坏在把「我能操作哪些城市」当成了「系统里有哪些城市」,无权限时选项直接消失而不是报错。
修复方向是换数据来源:城市选择框改用运营城市字典,候选与登录人无关;如果业务确实要限制某些人只能对某些城市发起调拨,这种限制应落在提交时的明确提示上,而不是让选项消失。这个案例只确认了换接口这一处改动,下面两段代码为脱敏教学示例,不代表实际项目源码或已上线实现。
错误代码
// 错误版:城市选择框的候选来自「按登录人过滤」的接口
public class StaffCityService {
// 前端城市选择框调用的 action
public static final String CITY_LIST_ACTION = "maint.staff.userCityList";
/** 按登录人的城市权限返回城市列表 */
public List<CityVO> userCityList(long staffId) {
List<String> permitted = staffCityPermissionRepository.findCityCodes(staffId);
// 为什么错:这里返回的是「这个人被授权的城市」,
// 未申请该城市权限的运维拿到的列表里根本没有这座城市,
// 而调用方把它当成系统的城市字典用,候选因此凭空少了一块
if (permitted.isEmpty()) {
return Collections.emptyList(); // 空列表被当成「没有城市」,不提示缺权限
}
return cityRepository.findByCodes(permitted);
}
}
修复代码示例
// 修复版:选择框改用运营城市字典,候选与登录人无关
public class CityDictionaryService {
// 前端城市选择框的 action 由 maint.staff.userCityList 切换到这里
public static final String CITY_LIST_ACTION = "maint.dictionary.operateCityList";
/** 运营城市字典:业务在运营的城市全量返回 */
public List<CityVO> operateCityList() {
// 不再读取按人的城市权限:有没有某城市的数据权限,
// 不影响这座城市是否出现在候选里
return cityRepository.findOperatingCities().stream()
.map(CityVO::of)
.collect(Collectors.toList());
}
}
下次遇到这些场景要警惕
- 给下拉、搜索、级联选择器挑接口时,先分清它返回的是业务字典还是按人的授权数据。用两个权限不同的账号打开同一张表单,比对候选是否一致;不一致就说明选项被权限过滤了,这类表单通常不该这么做。
- 授权类接口要区分「没有数据」和「没有权限」:返回空时页面给出可操作的提示,说清缺哪一项授权、去哪里申请。否则现场只能看到搜不到,问题会被当成功能故障反复报,真正的原因一直没被说出来。
- 新开一座城市或新增一个网点后,用一个只授权了部分城市的值班账号完整走一遍调拨单创建:搜城市、选网点、提交,确认目标城市能选到。只用全量权限的测试账号验证,权限过滤这条路径永远走不到。
- 改动选择器的数据来源时,把「这个接口的返回范围由什么决定」写进评审点:按人、按商户、按运营范围各是什么集合,取哪一个由业务决定,而不是由哪个接口先写好决定。