复杂路由注解传参：数组属性配置技巧

本文深入剖析了Spring Boot中路由注解（如@RequestMapping、@GetMapping）的数组属性本质——它们仅用于静态声明多路径匹配或请求条件筛选，**绝非接收运行时批量参数的通道**；文章明确划清“注解数组”与“参数接收”的边界，指出常见误区（如妄图用params接收configs数组），并系统给出三种生产级解决方案：基于JSON的@RequestBody接收复杂配置列表、基于重复key的@RequestParam处理简单ID数组、以及适用于表单场景的多值@RequestParam绑定，辅以清晰示例和避坑指南，助开发者彻底理清动态路由设计与批量参数传递的正确分层实践。

在 Spring Boot 中，复杂动态路由本身不直接支持“通过注解的数组属性传递批量配置参数”——因为像 @RequestMapping、@GetMapping 等注解的 value、params、headers 等数组属性，是用于**服务端静态声明路由规则或匹配条件**的，而非接收运行时传入的“批量配置参数”。真正接收批量参数，需靠请求体（@RequestBody）或查询/表单参数（@RequestParam），与路由注解的数组属性无关。

明确区分：注解数组属性 ≠ 参数接收容器

例如：

• @RequestMapping(value = {"/api/v1/users", "/api/v2/users"}) —— value 是字符串数组，定义多个可匹配路径，不是用来传参的；
• @GetMapping(params = {"format=json", "debug=true"}) —— params 是匹配条件数组，表示“仅当请求带这两个查询参数时才进该方法”，也不是接收它们的值；
• 你无法用 @RequestMapping(params = {"configs[]"}) 来接收一个叫 configs 的数组参数——这会报错或被忽略。

正确做法：路由动态化 + 批量参数独立传递

若你的真实需求是——“在动态前缀（如 /tenantA/api 或 /v2/resource）下，同时提交一批配置项（如开关列表、字段映射、策略 ID 数组）”，应拆解为两步：

• 路由动态化：用 @PathVariable 或自定义拦截器提取路径段（如租户码、版本号），不依赖注解数组；
• 批量参数接收：用标准参数注解接收实际数据，根据内容类型选择方式：

按场景选参数接收方式

① 前端发 JSON（推荐，适合复杂结构）

• 前端请求头：Content-Type: application/json；
• 后端用 @RequestBody 接收 List 或 DTO 数组：

@PostMapping("/{tenant}/config/batch")
public Result batchUpdate(@PathVariable String tenant, 
                         @RequestBody List configs) {
    // tenant = "tenantA"，configs 是 JSON 解析出的配置对象列表
    return configService.saveAll(tenant, configs);
}

② 前端发查询参数（适合简单类型，如 ID 列表）

• URL 示例：GET /v2/config?ids=101&ids=102&ids=103；
• 后端用 @RequestParam 绑定 List：

@GetMapping("/v2/config")
public Result listByIds(@RequestParam List ids) {
    return configService.findByIds(ids);
}

③ 前端发表单（application/x-www-form-urlencoded）

• 适用于 Vue/React 提交表单，或 jQuery $.ajax 普通 data；
• 同样用 @RequestParam，但需确保后端能解析多值（Spring 默认支持）：

@PostMapping("/config/import")
public Result importConfigs(@RequestParam("keys") List keys,
                           @RequestParam("values") List values) {
    // keys=["timeout", "retry"], values=["30", "2"]
    return configService.importMap(keys, values);
}

避免常见误区

• 不要试图把批量参数塞进 @RequestMapping.params —— 它只做匹配，不绑定值；
• 不要用 @MatrixVariable 传批量配置（已过时且默认禁用，易出错）；
• 动态路由前缀（如 /tenantA）应通过 @PathVariable 或拦截器提取，而非硬编码在注解数组里；
• 若需校验批量参数（如非空、唯一性），应在 DTO 层加 @Valid 注解，而非依赖路由注解。

今天关于《复杂路由注解传参：数组属性配置技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！