query string parameter后端怎么接收

### 如何在后端接收 Query String 参数 在 Web 开发中，后端通常通过 HTTP 请求中的查询字符串（query string）获取参数。以下是几种常见的方法用于 Spring Boot 后端接收查询字符串参数。 #### 方法一：使用 `@RequestParam` 注解 当需要从 URL 的查询字符串中提取单个或多个参数时，可以使用 `@RequestParam` 注解。此注解支持绑定 GET 和 POST 请求中的参数[^4]。 ```java @RestController @RequestMapping("/example") public class ExampleController { @GetMapping("/getParam") public String getParam(@RequestParam(name = "username", required = false, defaultValue = "guest") String username, @RequestParam(name = "age", required = true) int age) { return "Username: " + username + ", Age: " + age; } } ``` 上述代码展示了如何通过 `@RequestParam` 获取名为 `username` 和 `age` 的查询参数。如果未提供 `username` 参数，默认值为 `"guest"`；而 `age` 是必需的参数，缺少时会抛出异常。 --- #### 方法二：封装到对象中 对于复杂的查询条件，可以通过创建一个实体类来封装所有的查询参数。这样不仅可以减少控制器方法的参数数量，还能提高可读性和维护性[^3]。 ```java // 查询参数封装类 @Data public class QueryParams { private String username; private Integer age; } @RestController @RequestMapping("/example") public class ExampleController { @GetMapping("/getObject") public String getObject(QueryParams queryParams) { return "Username: " + queryParams.getUsername() + ", Age: " + queryParams.getAge(); } } ``` 在这种方式下，Spring 自动将查询字符串映射到 `QueryParams` 对象的字段上。 --- #### 方法三：处理重复参数 如果查询字符串中有重复的键名（例如 `http://localhost:8080/example/getList?ids=1&ids=2&ids=3`），可以将其解析为列表或数组形式。 ```java @GetMapping("/getList") public List<Integer> getList(@RequestParam("ids") List<Integer> ids) { return ids; } ``` 或者： ```java @PostMapping("/postArray") public String postArray(@RequestBody List<String> ids) { return "Received IDs: " + ids.toString(); } ``` 以上两种实现分别适用于不同的场景——前者适合简单的 GET 请求，后者更适合复杂数据结构的 POST 请求[^2]。 --- #### 方法四：路径变量 (`@PathVariable`) 虽然严格来说这不是直接操作查询字符串的方式，但在某些情况下可以用路径变量替代部分查询参数。 ```java @GetMapping("/pathVar/{id}") public String pathVar(@PathVariable("id") Long id) { return "ID from Path Variable: " + id; } ``` 这种设计风格更贴近 RESTful API 原则，在资源定位清晰的情况下推荐使用。 --- ### 注意事项 - 如果存在同名参数且目标类型为基本数据类型（如 `int` 或 `double`），只会保留第一个值。 - 当目标类型为集合或数组时，能够自动收集所有匹配项并填充至容器内。 - 需要特别注意安全性问题，尤其是涉及敏感信息传输时应采用 HTTPS 协议加密通信[^1]。 ---