Postman Query 参数功能定位

Query 参数通过 URL 的 ? 后以键值对形式传递，适用于过滤、分页或非敏感数据的轻量级传输。与 Body 参数相比，Query 参数可见性高且长度受限，但无需额外解析，适合 RESTful API 的 GET 请求场景。

场景适配与使用示例

1. 基础键值对传递
在 Postman 的请求 URL 输入框中直接附加参数：

https://api.example.com/users?name=John&age=25

Postman 的 Params 标签页可结构化填写键值，自动同步到 URL。

2. 数组/多值参数传递
重复键名或方括号语法支持多值：

https://api.example.com/search?tags=java&tags=python  
或  
https://api.example.com/search?tags[]=java&tags[]=python

3. 特殊字符编码
空格转为 + 或 %20，中文自动编码为 %E4%B8%AD 等形式。Postman 默认处理编码，无需手动操作。

Java 后端接收代码

1. Spring MVC 接收方式

@GetMapping("/users")
public ResponseEntity<List<User>> getUsers(
    @RequestParam String name,          // 单参数
    @RequestParam(required = false) Integer age,  // 可选参数
    @RequestParam List<String> tags     // 数组参数
) {
    // 业务逻辑
}

2. JAX-RS (Jakarta EE) 接收方式

@GET
@Path("/search")
public Response search(
    @QueryParam("keyword") String keyword,
    @DefaultValue("1") @QueryParam("page") int page
) {
    // 分页逻辑
}

3. 手动解析原生 Servlet

protected void doGet(HttpServletRequest request, HttpServletResponse response) {
    String name = request.getParameter("name"); 
    String[] tags = request.getParameterValues("tags"); // 多值参数
}

注意事项

• 敏感数据避免使用 Query 参数，防止 URL 日志泄露。
• 参数较多或复杂结构时改用 POST + Body 传输。
• 确保后端注解（如 @RequestParam）与前端参数名严格匹配，大小写敏感。