以下是關于Spring MVC中@RequestParam注解的詳細說明，用于在前后端參數名稱不一致時實現參數映射。包含代碼示例和總結表格：

---

1. 核心作用

@RequestParam用于顯式綁定HTTP請求參數到方法參數，支持以下場景：

• 參數名不一致：將前端參數名映射到后端方法參數名。
• 可選參數：指定參數是否必須。
• 默認值：當參數缺失時提供默認值。
• 類型轉換：自動將請求字符串轉換為指定類型。

---

2. 核心屬性

屬性	描述	示例
value	請求參數的名稱（必填或與name等效）	@RequestParam("username") String name
name	請求參數的名稱（與value等效）	@RequestParam(name = "ageStr") Integer age
required	是否必須（默認true）：若為false，參數缺失時返回null（包裝類型）或默認值	@RequestParam(required = false) String email
defaultValue	參數缺失時的默認值（需與類型兼容）	@RequestParam(defaultValue = "0") int age

---

3. 代碼示例

3.1 基礎用法：參數名不一致

@RestController
public class UserController {// 前端參數名為"username"，后端方法參數名為"name"@GetMapping("/user")public String getUser(@RequestParam("username") String name) {return "User name: " + name;}
}

3.2 可選參數與默認值

// 前端參數"age"可選，默認值為"18"
@GetMapping("/user/age")
public String getUserAge(@RequestParam(name = "age", required = false, defaultValue = "18") int age) {return "User age: " + age;
}

3.3 多參數綁定

// 綁定多個參數，部分參數使用默認值
@GetMapping("/user/details")
public String getUserDetails(@RequestParam("name") String username, @RequestParam(required = false, defaultValue = "N/A") String email,@RequestParam(defaultValue = "0") int score
) {return String.format("Name: %s, Email: %s, Score: %d", username, email, score);
}

3.4 類型轉換

// 將字符串參數轉換為Date類型（需配置日期轉換器）
@GetMapping("/user/birthday")
public String getBirthday(@RequestParam("birthday") @DateTimeFormat(pattern = "yyyy-MM-dd") Date birth) {return "Birthdate: " + birth;
}

---

4. 關鍵點說明

1. 參數名映射：

   • 當前端參數名（如frontendName）與后端參數名（如backendName）不一致時，通過value或name指定前端參數名：

     @RequestParam("frontendName") String backendName
     

2. 可選參數與默認值：

   • required = false：參數缺失時：
     • 包裝類型（如String、Integer）返回null。
     • 基本類型（如int）需通過defaultValue指定默認值，否則拋出異常。

3. 類型轉換：

   • Spring自動處理基本類型（如String→int）。
   • 復雜類型（如Date）需配置轉換器（如@DateTimeFormat）或自定義Converter。

4. 路徑變量與查詢參數：

   • 路徑變量必須使用@PathVariable注解，不能用@RequestParam。
   • 查詢參數（如?key=value）需通過@RequestParam綁定。

---

5. 常見錯誤與解決

錯誤場景	原因	解決方案
參數缺失且required = true	請求未提供必需參數	檢查請求參數或設置required = false和defaultValue。
類型轉換失敗（如字符串轉整數）	參數值不符合目標類型（如age=abc）	驗證參數格式或添加@RequestParam的defaultValue。
參數名不匹配（未使用value/name）	后端參數名與前端參數名不一致	使用@RequestParam("frontendName")顯式指定前端參數名。

---

6. 總結表格

場景	@RequestParam配置	示例	說明
參數名不一致	@RequestParam("frontendName") backendParam	@RequestParam("username") String name	映射前端參數名到后端參數名。
可選參數	@RequestParam(required = false)	@RequestParam(required = false) String email	參數缺失時返回null（包裝類型）或拋出異常（基本類型）。
默認值	@RequestParam(defaultValue = "defaultValue")	@RequestParam(defaultValue = "0") int score	參數缺失時使用默認值。
類型轉換	結合@DateTimeFormat或自定義轉換器	@RequestParam @DateTimeFormat(pattern="yyyy-MM-dd") Date birth	自動將字符串轉換為指定類型。
必填參數+默認值	@RequestParam(required = true, defaultValue = "...")	@RequestParam(required = true, defaultValue = "admin") String role	雖然required = true，但defaultValue可提供默認值（需注意邏輯）。

---

7. 完整代碼示例

UserController.java

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;import java.util.Date;@RestController
public class UserController {// 場景1：參數名不一致@GetMapping("/user/name")public String getUserName(@RequestParam("frontendName") String backendName) {return "Mapped name: " + backendName;}// 場景2：可選參數+默認值@GetMapping("/user/age")public String getUserAge(@RequestParam(required = false, defaultValue = "18") Integer age,@RequestParam(name = "email", required = false) String email) {return String.format("Age: %d, Email: %s", age, email);}// 場景3：類型轉換@GetMapping("/user/birth")public String getUserBirth(@RequestParam("birthday") @DateTimeFormat(pattern = "yyyy-MM-dd") Date birth) {return "Birthdate: " + birth;}// 場景4：多參數綁定@GetMapping("/user/details")public String getUserDetails(@RequestParam("username") String name,@RequestParam(required = false, defaultValue = "N/A") String email,@RequestParam(defaultValue = "0") int score) {return String.format("Name: %s, Email: %s, Score: %d", name, email, score);}
}

測試請求

1. 參數名映射：

   GET /user/name?frontendName=John → 返回 "Mapped name: John"
   

2. 可選參數+默認值：

   GET /user/age → 返回 "Age: 18, Email: null"
   

3. 類型轉換：

   GET /user/birth?birthday=1990-01-01 → 返回 "Birthdate: Sat Jan 01 00:00:00 CST 1990"
   

通過@RequestParam，可以靈活地將前端參數與后端參數映射，解決命名不一致的問題，同時支持可選參數、默認值和類型轉換。