REST端点如何获取可变查询参数并实现单端点适配多请求场景？

可变参数传递方案选型结论：优先选择查询参数，不建议使用GET请求JSON报文体 #

• 兼容性问题：HTTP RFC规范虽然没有明确禁止GET请求携带请求体，但绝大多数代理服务器、CDN、缓存服务、浏览器、HTTP客户端都会默认忽略甚至丢弃GET请求的请求体内容，生产环境出现异常的概率极高。
• 符合设计惯例：GET请求的查询参数本身就是为传递可选、可变的查询条件设计的，天然适配报表这类无副作用、幂等的查询场景，支持缓存、书签保存、请求日志直接排查问题，调试成本远低于GET带JSON体。
• 易用性更高：不管是前端拼接参数，还是测试工具调试，直接在URL后拼接查询参数的成本远低于构造GET请求的JSON报文体。

查询参数方案的实现逻辑 #

核心实现流程 #

• 第一步：提取路径变量定位报表类型：首先从URL路径中解析{subreport}路径参数，匹配到对应报表的处理逻辑类，比如subreport1对应A类，subreport2对应B类。
• 第二步：参数校验与转换：根据当前报表类型的参数要求，对传入的所有查询参数做合法性校验，比如subreport1要求param1、param2、param3三个参数必传，subreport2仅要求param1必传，校验不通过直接返回400参数错误。
• 第三步：路由分发执行：校验通过后将参数转换为对应报表的参数模型，传递给对应处理逻辑执行，返回报表结果。

示例代码（Java SpringBoot 场景） #

/**
 * 统一报表查询端点
 */
@RestController
@RequestMapping("/api/reports")
public class ReportController {

    // 自动注入所有报表处理器的工厂类
    @Autowired
    private ReportHandlerFactory reportHandlerFactory;

    @GetMapping("/{subreportType}")
    public ReportResult getReport(@PathVariable String subreportType,
                                  @RequestParam Map<String, Object> queryParams) {
        // 1. 获取对应报表的处理器
        ReportHandler handler = reportHandlerFactory.getHandler(subreportType);
        if (handler == null) {
            throw new BusinessException("非法的报表类型");
        }
        // 2. 参数校验和转换
        BaseReportParam param = handler.validateAndConvert(queryParams);
        // 3. 执行报表生成逻辑
        return handler.generate(param);
    }
}

// 处理器抽象接口
public interface ReportHandler {
    // 校验并转换参数
    BaseReportParam validateAndConvert(Map<String, Object> queryParams);
    // 生成报表
    ReportResult generate(BaseReportParam param);
    // 返回当前处理器对应的报表类型
    String getSupportType();
}

最佳实践建议 #

• 用策略模式+工厂模式管理所有报表的处理逻辑，新增报表仅需要新增ReportHandler的实现类即可，不需要修改统一入口代码，符合开闭原则。
• 可以借助参数校验框架（比如JSR-380校验注解）实现参数的自动校验，减少重复的校验代码编写。

内容的提问来源于stack exchange，提问作者Anu