一、@RequestMapping：Web请求的路由中枢

作为Spring MVC框架的核心注解，@RequestMapping承担着将HTTP请求精准映射到处理器方法的重任。该注解通过六个关键配置属性构建起灵活的请求匹配体系，其工作原理依赖于框架内部的RequestMappingHandlerMapping和RequestMappingHandlerAdapter组件协同完成。

1.1 核心配置属性详解

value/path：支持多路径映射的URL模式，可使用/api/users/{id}形式的路径变量，或通过/**实现通配符匹配。示例：
```
@RequestMapping(value = {"/user", "/member"}, method = RequestMethod.GET)
public List<User> getUsers() { ... }
```
method：精确控制HTTP方法，支持GET/POST/PUT/DELETE等标准方法，配合@GetMapping等派生注解可简化代码。
params：通过参数存在性或值匹配实现细粒度控制，如params="action=create"仅匹配包含该参数的请求。
headers：基于请求头过滤，例如headers="Content-Type=application/json"确保只处理JSON请求。
consumes：声明方法可消费的媒体类型，如consumes="application/xml"要求请求体为XML格式。
produces：指定响应内容类型，配合@ResponseBody实现自动内容协商。

1.2 类级与方法级组合映射

当注解同时作用于类和控制器方法时，框架会自动拼接路径前缀。这种分层设计极大提升了路由管理的灵活性：

@Controller
@RequestMapping("/api/v1")
public class UserController {
    @GetMapping("/users")  // 实际路径为 /api/v1/users
    public List<User> listUsers() { ... }
}

1.3 最佳实践建议

RESTful设计：结合路径变量和HTTP方法实现资源操作，如POST /users创建、PUT /users/{id}更新
版本控制：通过路径前缀（如/v1/）或自定义请求头实现API版本管理
安全过滤：在类级别添加@PreAuthorize注解实现批量权限控制
性能优化：对静态资源路径使用@RequestMapping的produces属性缓存控制

二、@RequestBody：请求体的智能解析器

在处理复杂请求体时，@RequestBody通过HttpMessageConverter机制实现自动反序列化，支持JSON/XML等多种格式的参数绑定。

2.1 数据绑定流程解析

内容协商：根据请求头Accept和Content-Type选择合适的转换器
反序列化：使用Jackson/Gson等库将JSON字符串转换为Java对象
字段映射：通过反射机制将请求体字段与对象属性自动匹配
校验处理：结合@Valid注解触发JSR-303验证规则

2.2 典型应用场景

2.2.1 复杂对象接收

@PostMapping("/users")
public ResponseEntity<?> createUser(@Valid @RequestBody UserDTO userDto) {
    // 自动完成JSON到UserDTO的转换及字段校验
    if (userDto.getPassword().length() < 8) {
        throw new IllegalArgumentException("密码长度不足");
    }
    // ...业务处理
}

2.2.2 动态参数处理

通过Map<String, Object>接收未知结构的参数：

@PostMapping("/dynamic")
public String handleDynamic(@RequestBody Map<String, Object> params) {
    // 灵活处理不同结构的请求体
    return "Received: " + params.toString();
}

2.3 高级配置技巧

自定义转换器：扩展HttpMessageConverter实现特殊格式处理
日期格式化：在DTO类中使用@JsonFormat指定日期格式
空值处理：通过@JsonInclude(Include.NON_NULL)控制序列化行为
松散绑定：使用@JsonProperty("user_name")处理不同命名风格的字段

三、注解协同工作模式

3.1 完整请求处理流程

路由匹配：RequestMappingHandlerMapping确定目标处理器方法
参数解析：HandlerMethodArgumentResolver处理@RequestBody等参数
校验执行：MethodValidationInterceptor触发验证逻辑
响应生成：RequestMappingHandlerAdapter协调内容转换

3.2 异常处理机制

当参数绑定失败时，框架会抛出MethodArgumentNotValidException或HttpMessageNotReadableException，可通过@ControllerAdvice统一处理：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<?> handleValidationExceptions(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach(error -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errors.put(fieldName, errorMessage);
        });
        return ResponseEntity.badRequest().body(errors);
    }
}

四、性能优化建议

减少反射调用：对高频接口考虑使用代码生成技术（如Lombok的@Builder）
复用转换器：缓存ObjectMapper等转换实例避免重复创建
异步处理：对耗时操作使用@Async注解结合响应式编程
批量操作：通过@RequestBody List<T>接收批量数据减少网络往返

通过系统掌握这两个核心注解的工作机制和最佳实践，开发者能够构建出既符合RESTful规范又具备高可维护性的Web应用。在实际项目中，建议结合Swagger等工具生成API文档，并配合日志服务实现全链路监控，进一步提升开发效率和系统可靠性。

Spring Web MVC核心注解解析：从请求映射到参数绑定