发生了什么

商户后台是商户登录后查看自己名下门店的页面。账号登录后,页面第一步要加载一份可见范围:这个账号被授权查看哪些二级商户,以及这些商户下面有哪些门店。所谓数据权限,就是平台给账号配的一张白名单,写明它能看哪几个二级商户;门店列表再把这张白名单里的商户展开成门店,展示给用户。

正常流程是:账号登录,系统按账号读出数据权限,得到一组授权商户编号;查询门店时把这组编号作为筛选条件带上,只返回这些商户名下的门店。

这次的情况是:一个账号登录后页面一直加载失败,换成另一台手机登录,仍然失败。可见问题不在设备或客户端,而在账号对应的这份数据上。这个账号没有配置具体的二级商户数据权限,系统读不到任何授权商户。本来应该把它理解为“这个账号没有任何可见范围”,但程序没有停下,而是继续往下查门店;查询时因为没有可用的商户编号,干脆不加商户条件,于是把平台上的全部门店都查了出来。这个结果太大,超过了服务之间单次响应的大小上限(该服务为 10MB),查询请求被直接拒绝,页面拿不到数据,表现成加载失败。

影响范围是权限未配置、或者配置范围大到足以让返回结果超限的账号:这类账号打开门店列表必现报错,不是偶发。当时的临时办法是调整这个账号的权限、缩小可见商户数量,把数据量压回上限以下;这绕开了触发条件,门店查询本身仍然没有防护。

本质

问题不在登录和鉴权,而在“权限为空”被当成了“不加限制”。

  1. 读权限的程序查不到该账号的二级商户数据权限,走了“权限不存在”的分支,直接构造了一个空的权限对象返回。这一步把“没配置”变成了“有对象、但授权商户列表为空”,并且没有在任何地方声明空列表意味着什么。
  2. 组织门店查询条件时,程序只在授权商户列表非空时才把商户编号写进条件;列表为空,就跳过这一步,查询条件里没有任何商户编号。
  3. 查询因此变成了不带商户条件的全量查询,返回的是全平台门店。门店数量越多,返回体越大。
  4. 这组结果要经过服务间的 gRPC 调用传回调用方,单次消息有大小上限。返回体超过 10MB 后,请求直接被拒绝并报 ResourceExhausted,调用方拿不到列表,页面只能停在加载状态。

空授权列表被当作“不加限制”,于是“没有任何可见范围”被放大成“全部可见”,全量结果又撑破传输上限。

这条链路上有两处可以拦住它,而当时两处都放行了:读权限的地方没有把空授权当拒绝,组织查询的地方把空条件当无限制。没有配置权限本身是合法的业务状态,出错的是这个状态流到查询层之后的翻译。

修复方向是:授权列表为空且不是全选时,直接返回空结果,不发起下游查询;门店查询增加分页,并对单次查询的商户数量设上限,超过时分批查询再合并。空权限的语义和分页上限要一起改,只改一处仍可能被大范围权限再次触发。

错误代码

public class StoreQueryService {

    public List<StoreVO> listStores(long operatorId) {
        MerchantAccessCache cache = accessService.load(operatorId);
        List<Long> authMerchantIds = cache.getMerchantIds();

        StoreQuery query = new StoreQuery();
        // 为什么错:授权商户为空时不拦截,条件里就没有商户编号
        if (!authMerchantIds.isEmpty()) {
            query.setMerchantIds(authMerchantIds);
        }
        // 为什么错:没有商户条件就是全量查询,返回体远超单次响应上限
        return storeMapper.selectByQuery(query);
    }
}

class MerchantAccessService {

    public MerchantAccessCache load(long operatorId) {
        return accessRepository.findByOperator(operatorId)
                // 为什么错:没配二级商户权限时造一个空缓存返回,
                // 空列表一路流到查询层,等于把“无权限”放大成“全部”
                .orElseGet(MerchantAccessCache::new);
    }
}

修复代码示例

public class StoreQueryService {

    // 单次查询的商户数上限为示意值,应按实际响应体上限评估
    private static final int MAX_PAGE_SIZE = 500;

    public StorePage listStores(long operatorId, int pageNo, int pageSize) {
        MerchantAccessCache cache = accessService.load(operatorId);
        List<Long> authMerchantIds = cache.getMerchantIds();

        // 修复:空授权且非全选,说明没有可见范围,直接返回空结果
        if (authMerchantIds.isEmpty() && !cache.isAllFlag()) {
            return StorePage.empty(pageNo, pageSize);
        }
        // 修复:查询带分页和单次上限,响应体不再随门店总数增长
        int safeSize = Math.min(pageSize, MAX_PAGE_SIZE);
        return storeMapper.selectPage(authMerchantIds, cache.isAllFlag(), pageNo, safeSize);
    }
}

两段代码是脱敏教学示例,用来说明错误与修复思路,不代表实际项目源码或已上线实现。修复的关键有两处:读权限时把“查不到”明确成“没有可见范围”,查询时用分页和上限约束返回体大小;全选场景同样要走分页,否则权限范围一放开,全量查询又会回来。

下次遇到这些场景要警惕

  • 给账号体系加可选的数据权限配置:先定义“没配置”是拒绝还是全量,并在读权限的代码里落成明确的返回值;只写“查不到就返回空对象”,等于把这个语义留给下游猜。
  • 看到“列表为空就不加这个查询条件”的写法:逐个往下推一遍空集合会被翻译成什么。用空权限账号和范围很大的账号各查一次,比对返回行数,确认前者是 0 条而不是全部。
  • 列表接口放开权限范围或加字段:先打印一次正常返回体的大小,按门店数量翻倍估算体积,再定分页大小和单次上限,不要等报错才发现已经超限。
  • 遇到“换个设备还是失败”的反馈:先按账号维度查数据——权限配置、返回体大小、服务端错误码,再考虑客户端兼容性,避免把服务端错误误判成设备问题。