以下是关于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，可以灵活地将前端参数与后端参数映射，解决命名不一致的问题，同时支持可选参数、默认值和类型转换。