一、@RequestBody 注解詳解

1. 基本使用

作用：從 HTTP 請求體中獲取數據，適用于 POST/PUT 請求。
限制：GET 請求無請求體，不可使用該注解。

示例代碼

@Controller
@RequestMapping("/demo01")
public class Demo01Controller {@PostMapping("/test1")public void test1(@RequestBody String requestBody, HttpServletResponse response) throws IOException {System.out.println("請求體內容：" + requestBody);response.getWriter().write(requestBody);}
}

前端測試方式

1. 表單提交（默認格式：application/x-www-form-urlencoded）

<form action="/demo01/test1" method="post"><input type="text" name="id"><input type="text" name="name"><input type="submit">
</form>

輸出示例：id=2&name=zhangsan

2. AJAX JSON 提交

$("#btn").click(function() {const data = { id: 1, name: "吉林省" };$.post({url: "/demo01/test1",contentType: "application/json",data: JSON.stringify(data),success: function(res) { console.log(res); }});
});

輸出示例：{"id":1,"name":"吉林省"}

---

2. JSON 數據綁定

要求：

• 請求頭必須包含 Content-Type: application/json
• 需要 jackson-databind 依賴支持 JSON 轉換

實體類與控制器

@Data // Lombok 注解，自動生成 getter/setter
public class Province {private Integer id;private String name;
}@RestController
@RequestMapping("/demo01")
public class Demo01Controller {@PostMapping("/test2")public Province test2(@RequestBody Province province) {System.out.println("接收對象：" + province);return province; // 自動轉為 JSON 返回}
}

前端測試

$("#btn").click(function() {const province = { id: 2, name: "重慶" };$.post({url: "/demo01/test2",contentType: "application/json",data: JSON.stringify(province),success: function(res) { console.log(res); }});
});

輸出結果：Province(id=2, name=重慶)

---

二、文件上傳實戰

1. 環境配置

依賴引入

<!-- 文件上傳核心依賴 -->
<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.4</version>
</dependency>

Spring 配置文件

<!-- 配置 MultipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="maxUploadSize" value="10240000"/> <!-- 最大10MB --><property name="defaultEncoding" value="UTF-8"/>
</bean>

---

2. 單文件上傳

前端表單

<form enctype="multipart/form-data" action="/demo01/upload" method="post"><input type="file" name="myfile"><input type="submit">
</form>

控制器實現

@PostMapping("/upload")
public void uploadFile(@RequestPart("myfile") MultipartFile file, HttpServletResponse response) throws IOException {// 獲取文件信息String fileName = file.getOriginalFilename();long size = file.getSize();// 保存到磁盤file.transferTo(new File("D:/uploads/" + fileName));// 返回響應response.setContentType("text/html;charset=utf-8");response.getWriter().write("文件名：" + fileName + "<br>大小：" + size + "字節");
}

---

3. 多文件上傳

前端表單

<form enctype="multipart/form-data" action="/demo01/uploads" method="post"><input type="file" name="myfiles" multiple><input type="file" name="myfiles"><input type="submit">
</form>

控制器實現

@PostMapping("/uploads")
public String uploadFiles(@RequestPart("myfiles") MultipartFile[] files) throws IOException {for (MultipartFile file : files) {if (!file.isEmpty()) {file.transferTo(new File("D:/uploads/" + file.getOriginalFilename()));}}return "上傳成功！共處理 " + files.length + " 個文件";
}

---

三、注意事項

1. 文件上傳限制
   • 表單必須設置 enctype="multipart/form-data"
   • 提交方式必須為 POST
2. 常見錯誤
   • 415 錯誤：未正確設置 Content-Type: application/json
   • 文件大小超限：檢查 maxUploadSize 配置
3. 依賴問題
   • 確保 Lombok、Jackson、commons-fileupload 版本匹配

---

通過本教程，您已掌握 Spring MVC 中請求體數據綁定和文件上傳的核心技術。建議結合代碼示例進行實際操作練習。