Postman 中，参数可以放在 Params 或 Body 里的详细介绍_post请求参数放在body里面

在 Postman 中，参数可以放在 Params 或 Body 里，而 Body 里又有不同的格式，比如 form-data 和 x-www-form-urlencoded。不同的参数传递方式，Spring Boot 代码写法也不同。下面是详细的区别和代码示例。

1. Params（查询参数 ?key=value）

适用场景：

• GET 请求：一般用于传递非敏感参数，如搜索条件、分页参数等。

• POST/PUT 请求：可用，但不常用，数据一般放 Body 里。

Postman 设置

• 方法：GET 或 POST

• URL：http://localhost:8083/api/test?name=Tom&age=25

• Params（键值对）：

Spring Boot 代码

@RestController@RequestMapping(\"/api\")public class TestController { @GetMapping(\"/test\") public ResponseEntity<String> test(@RequestParam String name, @RequestParam int age) { return ResponseEntity.ok(\"Name: \" + name + \", Age: \" + age); }}

2. Body - x-www-form-urlencoded

适用场景：

• POST/PUT 请求，用于发送表单数据，Content-Type 是 application/x-www-form-urlencoded。

• 适合 表单提交、登录请求等。

Postman 设置

• 方法：POST

• URL：http://localhost:8083/api/form

• Body 选项：选择 x-www-form-urlencoded
  

Spring Boot 代码

@PostMapping(\"/form\")public ResponseEntity<String> formTest(@RequestParam String name, @RequestParam int age) { return ResponseEntity.ok(\"Received form data - Name: \" + name + \", Age: \" + age);}

3. Body - form-data

适用场景：

上传文件，例如头像、Excel 文件等（支持 multipart/form-data）。

传输键值对（类似 x-www-form-urlencoded），但更适合含 文件 的请求。

Postman 设置

• 方法：POST

• URL：http://localhost:8083/api/upload

• Body 选项：选择 form-data

Spring Boot 代码

@PostMapping(\"/upload\")public ResponseEntity<String> uploadFile( @RequestParam String name, @RequestParam int age, @RequestParam(\"file\") MultipartFile file) { return ResponseEntity.ok(\"Received: \" + name + \", Age: \" + age + \", File: \" + file.getOriginalFilename());}

4. Body - raw (JSON)

适用场景：

POST/PUT 请求，传递 JSON 格式数据，Content-Type 是 application/json。

适用于 REST API，推荐！

Postman 设置

• 方法：POST

• URL：http://localhost:8083/api/json

• Body 选项：选择 raw，格式 JSON

{ \"name\": \"Tom\", \"age\": 25}

Spring Boot 代码

@PostMapping(\"/json\")public ResponseEntity<String> jsonTest(@RequestBody Map<String, Object> data) { String name = data.get(\"name\").toString(); int age = Integer.parseInt(data.get(\"age\").toString()); return ResponseEntity.ok(\"Received JSON - Name: \" + name + \", Age: \" + age);}

或者使用 DTO（推荐！）：

public class Person { private String name; private int age; // 省略 Getter & Setter}@PostMapping(\"/json\")public ResponseEntity<String> jsonTest(@RequestBody Person person) { return ResponseEntity.ok(\"Received JSON - Name: \" + person.getName() + \", Age: \" + person.getAge());}

总结