发生了什么

商户后台是商户查看自己经营数据的页面。商户登录后打开数据页,页面按选定的时间范围展示这段时间的数据。这些数字不是页面自己算出来的:页面只负责展示,取数由报表服务完成——它按商户编号和时间范围查出明细、做汇总,拼成一个结果列表返回给页面。一级商是平台下的一层商户,这类商户登录的也是同一个商户后台。

正常流程是:商户登录,打开数据页,页面带着商户编号和时间范围调用报表查询接口,报表服务查出明细、拼成结果列表,页面按列表渲染。列表里有几条就返回几条,页面上就显示几条。

问题出在 2024 年 4 月 7 日的一次改动上。报表服务同时为多条业务线出数,几条业务线的报表共用同一套取数、拼装代码。报表服务的开发为了修另一条业务线的报表问题,在结果拼好之后加了一步 removeIf 过滤。第二天中午,一级商打开商户后台看数据,页面上没有任何数据。

本质

问题不在数据本身,而在结果返回之前的那一步。

这段过滤代码拿到的列表并不总是可变列表。一种常见写法是:查询只命中一条时,直接把这条包成 Collections.singletonList 返回,省一次拷贝。这个方法返回的是 Collections$SingletonList,一个只有一个元素、不能增删的只读视图。removeIf 的语义是“按条件删除元素”;对只读视图执行删除,运行时不看条件、也不管要删的是哪一条,直接抛 UnsupportedOperationException(一种运行时异常)。

异常发生在报表服务的查询链路上。查询没有走完,接口就没有把结果列表返回给页面;页面拿不到列表,只能显示为空。所以这次“看不到数据”和数据缺失、权限、筛选条件都没有关系:数据在库里是完整的,失败发生在数据已经查出来、还没来得及返回的那一行。

只要执行到这段过滤就一定会抛异常,与筛掉哪条数据无关。

这次改动的作用范围也值得注意:它改的是多条业务线共用的结果拼装路径,目的只是修另一条业务线的报表问题,但同一段代码同时服务商户后台。改动之后,一级商的商户后台就看不到数据了。

至于哪些商户、哪个页面会走到这段过滤,取决于代码里的分支条件,事发时没有逐项确认;可以确认的是,这个删除操作一被调用就抛异常,不存在“有时成功、有时失败”。

修复方向是:不要让过滤依赖上游返回的列表类型。查询结果先落到一个可变列表,或直接用流式过滤生成新列表,再在副本上过滤;这样无论上游返回普通列表、只读视图还是定长视图,都不会在执行删除时抛异常。共用取数代码的改动,还应把其它业务线的调用方一并纳入验证。

错误代码

public class ReportQueryService {

    List<Row> queryReport(Long merchantId, DateRange range) {
        List<Row> rows = reportMapper.selectRows(merchantId, range);
        // 单条结果用只读单元素列表返回,省掉一次拷贝
        List<Row> result = rows.size() == 1
                ? Collections.singletonList(rows.get(0))
                : new ArrayList<>(rows);
        // 为什么错:singletonList 是只读视图,不支持删除元素,
        // 执行到这一行就抛 UnsupportedOperationException
        result.removeIf(this::shouldDrop);
        return result;
    }
}

修复代码示例

public class ReportQueryService {

    List<Row> queryReport(Long merchantId, DateRange range) {
        List<Row> rows = reportMapper.selectRows(merchantId, range);
        // 先复制到可变列表,过滤只作用于自己的副本
        List<Row> result = new ArrayList<>(rows);
        // 列表一定可变,过滤不再依赖上游返回的列表类型
        result.removeIf(this::shouldDrop);
        return result;
    }

    // 也可以不改原列表,直接生成过滤后的新列表
    List<Row> queryReportFiltered(Long merchantId, DateRange range) {
        return reportMapper.selectRows(merchantId, range).stream()
                .filter(row -> !shouldDrop(row))
                .collect(Collectors.toList());
    }
}

两段代码是脱敏教学示例,用来说明错误与修复思路,不代表实际项目源码。修复的关键是把过滤作用在可变的副本上,而不是假设上游给的列表一定能删元素。

下次遇到这些场景要警惕

  • 在共用的取数或拼装代码里加过滤:先列出这段代码的全部调用方(哪几条业务线、哪些页面),改完后逐条用真实数据打开页面看结果;只验证要修的那条业务线,等于让另一条业务线替你发现问题。
  • 对方法返回的列表做 removeIf、removeAll、retainAll 或 sort:先确认列表是否可变。Collections.singletonList、Arrays.asList、List.of 返回的都是只读或定长视图,需要过滤就生成新列表,不要就地改。
  • 排查“列表页没有数据”:先分清是数据不存在、查询失败还是渲染失败。直接调一次该页面对应的接口,看它是否真的返回了 200 和列表,再翻服务端日志确认这个分支有没有抛异常。
  • 设计和自测查询:0 条、1 条、多条三种结果各跑一次。单条结果最容易走到只读列表的快捷写法,只测多条会漏掉。