ps：如果这篇帖子对于还在找工作和找实习的你有所帮助，可以关注我，给本贴点赞、评论、收藏并订阅专栏；同时不要吝啬您的花花

一、GET请求与POST请求核心区别

GET和POST同属HTTP请求方法，本质差异源于HTTP协议设计语义和数据传输机制，并非简单的“参数位置不同”。以下从核心维度做对比梳理：

误区纠正：GET和POST的安全性、长度限制并非协议强制规定，而是浏览器/服务器的实现限制；POST也并非绝对安全，仅解决了参数可见性问题。

二、POST请求体的4种主流格式（Content-Type）

POST请求通过Content-Type请求头标识请求体格式，日常开发中核心有4种，覆盖绝大多数业务场景：

1. application/x-www-form-urlencoded（默认表单格式）

浏览器原生表单默认格式，数据以键值对&拼接形式传输，类似GET的Query参数，仅存放于请求体。仅支持文本数据，不支持文件上传。

示例：username=zhangsan&password=123456

2. multipart/form-data（多部分表单格式）

专门用于文件上传+文本参数混合传输，请求体被分割为多个独立部分，每部分携带独立请求头，支持二进制文件、文本参数同时提交。

3. application/json（JSON格式）

前后端分离主流格式，请求体为标准JSON字符串，支持复杂对象、数组、嵌套结构传输，可读性和扩展性极强，是接口开发首选。

示例：{"username":"zhangsan","age":20,"hobbies":["篮球","读书"]}

4. binary（二进制流格式，application/octet-stream）

纯二进制数据传输，无固定结构，通常用于传输单个文件、字节流，不支持键值对参数，多用于文件下载、大文件流式上传。

三、Spring Boot Controller对应接收方式

针对上述4种POST请求体格式，Spring Boot提供了专属注解和接收方式，以下为实操代码示例：

1. 接收 application/x-www-form-urlencoded 格式

使用@RequestParam注解接收单个键值对，或用实体类+省略注解自动映射（Spring会自动绑定表单参数到实体属性）。

@RestController
@RequestMapping("/post")
public class PostController {
    // 单个参数接收
    @PostMapping("/form1")
    public String form1(@RequestParam String username, @RequestParam String password) {
        return "接收表单参数：username=" + username + ", password=" + password;
    }

    // 实体类自动映射
    @PostMapping("/form2")
    public String form2(User user) {
        return "接收实体参数：" + user.toString();
    }
}
// 实体类
class User {
    private String username;
    private String password;
    // getter/setter/toString
}

2. 接收 multipart/form-data 格式（文件+参数）

文本参数用@RequestParam，文件用MultipartFile接收；多文件/混合场景可用@RequestPart注解。

@PostMapping("/upload")
public String upload(@RequestParam String remark, @RequestParam MultipartFile file) {
    // 获取文件名
    String fileName = file.getOriginalFilename();
    // 文件处理逻辑（存储、解析等）
    return "上传备注：" + remark + "，文件名：" + fileName;
}

// 多文件上传
@PostMapping("/uploadBatch")
public String uploadBatch(@RequestParam MultipartFile[] files) {
    return "批量上传文件数：" + files.length;
}

3. 接收 application/json 格式

必须使用@RequestBody注解，将JSON字符串自动反序列化为Java实体类/Map集合，仅支持POST/PUT等带请求体的请求。

@PostMapping("/json")
public String json(@RequestBody User user) {
    return "接收JSON参数：" + user.toString();
}

// 接收Map类型（无需实体类）
@PostMapping("/jsonMap")
public String jsonMap(@RequestBody Map<String, Object> paramMap) {
    return "接收Map参数：" + paramMap.toString();
}

4. 接收 binary 二进制流格式

通过HttpServletRequest获取输入流，直接读取二进制数据，适用于纯文件流传输。

@PostMapping("/binary")
public String binary(HttpServletRequest request) throws IOException {
    // 获取输入流读取二进制数据
    InputStream inputStream = request.getInputStream();
    // 字节数组接收文件流
    byte[] bytes = inputStream.readAllBytes();
    return "接收二进制数据长度：" + bytes.length;
}

四、补充注意事项

• @RequestBody 冲突问题：一个接口只能有一个@RequestBody注解，无法同时接收多个JSON对象；复杂场景可封装为嵌套实体类。
• 文件上传限制：Spring Boot默认文件上传大小有限制，需在application.yml配置修改：spring.servlet.multipart.max-file-size=100MB。
• 参数必填校验：可搭配@NotBlank、@NotNull等校验注解，实现参数合法性校验。
• GET请求也可携带请求体，但不符合HTTP协议语义，绝大多数服务器不支持，严禁生产环境使用。

ps：如果这篇帖子对于还在找工作和找实习的你有所帮助，可以关注我，给本贴点赞、评论、收藏并订阅专栏；同时不要吝啬您的花花