如何在Postman中传递多参数及Spring Boot请求体传多变量

一、Spring Boot后端实现 #

1. 使用DTO类接收（推荐规范写法） #

定义一个包含所有需要参数的DTO（数据传输对象）类，通过@RequestBody注解绑定请求体内容到该类实例，这种方式可读性和可维护性最强。

// 定义请求体DTO类
public class UserRequest {
    private String username;
    private Integer age;
    private String email;

    // 手动生成getter、setter方法，或使用Lombok的@Data注解简化代码
    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

// Controller层接口
@RestController
@RequestMapping("/api/users")
public class UserController {

    @PostMapping("/create")
    public ResponseEntity<String> createUser(@RequestBody UserRequest userRequest) {
        // 业务逻辑处理示例
        String result = String.format("接收参数：用户名=%s，年龄=%d，邮箱=%s", 
                                     userRequest.getUsername(), 
                                     userRequest.getAge(), 
                                     userRequest.getEmail());
        return ResponseEntity.ok(result);
    }
}

2. 使用Map接收（快速测试场景） #

如果只是临时测试不想创建DTO类，可以直接用Map<String, Object>接收请求体参数，适合快速验证接口。

@RestController
@RequestMapping("/api/users")
public class UserController {

    @PostMapping("/create-with-map")
    public ResponseEntity<String> createUserWithMap(@RequestBody Map<String, Object> params) {
        String username = (String) params.get("username");
        Integer age = (Integer) params.get("age");
        String email = (String) params.get("email");
        
        String result = String.format("Map接收参数：用户名=%s，年龄=%d，邮箱=%s", username, age, email);
        return ResponseEntity.ok(result);
    }
}

二、Postman中传递多个请求体参数的步骤 #

以JSON格式请求体为例（后端用@RequestBody接收的标准方式）：

1. 打开Postman，新建一个POST请求，填入接口的完整URL（比如http://localhost:8080/api/users/create）
2. 切换到Body标签页，选择raw选项，然后在右侧的格式下拉菜单中选择JSON
3. 在编辑区域输入包含多个参数的JSON内容，示例：

{
    "username": "zhangsan",
    "age": 25,
    "email": "zhangsan@example.com"
}

4. 点击Send按钮发送请求，即可在响应区域看到后端返回的结果

注意：如果后端是用表单格式（x-www-form-urlencoded）接收参数，不需要@RequestBody，直接在Postman的Body中选择x-www-form-urlencoded，然后逐个添加键值对即可，但这种不属于请求体JSON传递的范畴。

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