SpringBoot 中 @RequestMapping 及衍生注解的全面解析与实践

关注

VIP免费原创最新推荐文章于 2026-06-05 11:07:07 发布 2k 阅读 AI 写同款· GEO 优化 ›

Spring Boot中的@RequestMapping注解在Spring Boot中，@RequestMapping是一个非常重要的注解，用于映射HTTP请求到控制器方法。它是Spring Framework中用于处理请求映射的核心注解之一。通过@RequestMapping注解，我们可以将不同URL请求映射到对应的控制器方法，从而实现对Web应用程序的处理和响应。阅读详情

在 SpringBoot 开发中，控制器（Controller）是处理 HTTP 请求的核心组件，而@RequestMapping及其衍生注解则是构建 RESTful API 的基础。本文将从注解的工作原理、使用场景到高级特性，全面解析这些注解的用法，帮助开发者写出更优雅、更符合 REST 规范的接口。

一、@RequestMapping 注解的核心作用

@RequestMapping是 Spring MVC 中用于映射 HTTP 请求到控制器方法的核心注解，它可以标注在类上或方法上，具有以下核心功能：

映射 URL 路径到控制器方法

限制请求方法（GET、POST 等）

限制请求参数

限制请求头

定义请求媒体类型

基本使用示例

@RestController
@RequestMapping("/api/users") // 类级别映射
public class UserController {
    
    // 方法级别映射
    @RequestMapping(method = RequestMethod.GET)
    public List<User> getAllUsers() {
        // 业务逻辑
    }
}

上述代码中，类上的@RequestMapping("/api/users")定义了基础路径，方法上的注解则进一步指定了处理 GET 请求，因此该方法将处理GET /api/users请求。

二、HTTP 方法特定的衍生注解

为了简化常用 HTTP 方法的映射，Spring 提供了一系列@RequestMapping的衍生注解，这些注解在功能上等价于指定了method属性的@RequestMapping，但使代码更具可读性。

1. @GetMapping

用于处理 HTTP GET 请求，等价于@RequestMapping(method = RequestMethod.GET)。

典型应用场景：查询资源、获取数据

@GetMapping("/{id}")
public ResponseEntity<User> getUserById(@PathVariable Long id) {
    User user = userService.findById(id);
    return ResponseEntity.ok(user);
}

2. @PostMapping

用于处理 HTTP POST 请求，等价于@RequestMapping(method = RequestMethod.POST)。

典型应用场景：创建新资源

@PostMapping
public ResponseEntity<User> createUser(@RequestBody @Valid User user) {
    User savedUser = userService.save(user);
    URI location = ServletUriComponentsBuilder
        .fromCurrentRequest()
        .path("/{id}")
        .buildAndExpand(savedUser.getId())
        .toUri();
    return ResponseEntity.created(location).body(savedUser);
}