> **💡 导语**：
> 在Spring Boot的世界里，**注解**（Annotation）是开发者最强大的武器。它用简洁的代码替代了繁琐的XML配置，让开发变得“开箱即用”。但面对海量的注解，你是否感到眼花缭乱？哪些是核心必备？哪些是进阶利器？
>
> 本文为你精心整理并详解 **100个最常用、最核心的Spring Boot注解**，按功能模块分类，从 **项目启动、Web开发、数据访问、安全控制** 到 **测试验证**，一网打尽！无论你是刚入行的新手，还是经验丰富的老鸟，这篇文章都将成为你日常开发的**终极速查手册**！

---

## 🧱 第一部分：核心基石 - 项目启动与Bean管理

这是Spring Boot应用的骨架，所有功能都建立在此之上。

### 1. `@SpringBootApplication` (⭐ 必知必会)
*   **作用**：Spring Boot应用的**核心启动注解**，一个顶仨！
*   **组合**：`@Configuration` + `@EnableAutoConfiguration` + `@ComponentScan`
*   **用法**：标记在主启动类上。
    ```java
    @SpringBootApplication
    public class MyApplication {
        public static void main(String[] args) {
            SpringApplication.run(MyApplication.class, args);
        }
    }
    ```

### 2. `@Configuration`
*   **作用**：声明一个类为**配置类**，替代传统的XML配置文件。
*   **用法**：通常与`@Bean`配合使用。

### 3. `@Bean`
*   **作用**：在配置类的方法上使用，将方法的返回值注册为Spring容器中的一个**Bean**。
    ```java
    @Configuration
    public class AppConfig {
        @Bean
        public UserService userService() {
            return new UserServiceImpl();
        }
    }
    ```

### 4. `@Component`
*   **作用**：**通用组件**注解。被此注解标记的类会被Spring自动扫描并纳入IoC容器管理。
*   **用法**：适用于任何需要被Spring管理的普通类。

### 5. `@Service`
*   **作用**：`@Component`的**特化版**，专门用于标注**业务逻辑层**（Service Layer）的组件。语义更清晰。

### 6. `@Repository`
*   **作用**：`@Component`的**特化版**，专门用于标注**数据访问层**（DAO/Repository Layer）的组件。它还能自动将数据库异常转换为Spring的统一数据访问异常。

### 7. `@Controller`
*   **作用**：`@Component`的**特化版**，专门用于标注**Spring MVC的控制器**（Controller）。

### 8. `@RestController`
*   **作用**：`@Controller` + `@ResponseBody` 的**组合注解**。用于构建**RESTful Web服务**，方法返回值会直接作为HTTP响应体（通常是JSON）。
    ```java
    @RestController
    public class UserController {
        @GetMapping("/user/{id}")
        public User getUser(@PathVariable Long id) {
            // ...
        }
    }
    ```

### 9. `@ComponentScan`
*   **作用**：配置Spring需要**扫描哪些包**来查找带有`@Component`等注解的类。`@SpringBootApplication`已默认包含，通常无需手动指定。

### 10. `@Autowired`
*   **作用**：**自动装配**。Spring会根据类型（或名称）自动将所需的Bean注入到字段、构造函数或Setter方法中。
    ```java
    @Service
    public class OrderService {
        @Autowired
        private PaymentService paymentService; // 字段注入
        
        // 或者构造器注入（推荐）
        public OrderService(PaymentService paymentService) {
            this.paymentService = paymentService;
        }
    }
    ```

### 11. `@Qualifier`
*   **作用**：当存在**多个同类型**的Bean时，与`@Autowired`配合使用，通过**名称**指定要注入哪一个。
    ```java
    @Autowired
    @Qualifier("alipayPaymentService")
    private PaymentService paymentService;
    ```

### 12. `@Primary`
*   **作用**：当存在多个同类型的Bean时，标记其中一个为**首选**Bean。如果没有`@Qualifier`指定，Spring会优先注入`@Primary`标记的Bean。

### 13. `@Scope`
*   **作用**：定义Bean的**作用域**。
    *   `singleton` (默认): 整个应用中只有一个实例。
    *   `prototype`: 每次请求都创建一个新实例。
    *   `request`: 每个HTTP请求创建一个实例（仅Web应用）。
    *   `session`: 每个HTTP会话创建一个实例（仅Web应用）。

### 14. `@PostConstruct`
*   **作用**：标记一个方法，在Bean被**初始化之后**执行（依赖注入完成后）。常用于初始化操作。

### 15. `@PreDestroy`
*   **作用**：标记一个方法，在Bean被**销毁之前**执行。常用于释放资源。

### 16. `@DependsOn`
*   **作用**：强制指定当前Bean在初始化**之前**，必须先初始化另一个（或多个）Bean。

---

## 🌐 第二部分：Web开发利器 - 构建API与处理请求

这是构建Web应用和REST API的核心。

### 17. `@RequestMapping`
*   **作用**：**通用**的请求映射注解，可以映射HTTP方法、URL、参数、Header等。
*   **属性**：`value`(URL), `method`(GET/POST等), `params`, `headers`, `consumes`, `produces`。

### 18. `@GetMapping`
*   **作用**：`@RequestMapping(method = RequestMethod.GET)` 的**快捷方式**。

### 19. `@PostMapping`
*   **作用**：`@RequestMapping(method = RequestMethod.POST)` 的**快捷方式**。

### 20. `@PutMapping`
*   **作用**：`@RequestMapping(method = RequestMethod.PUT)` 的**快捷方式**。

### 21. `@DeleteMapping`
*   **作用**：`@RequestMapping(method = RequestMethod.DELETE)` 的**快捷方式**。

### 22. `@PatchMapping`
*   **作用**：`@RequestMapping(method = RequestMethod.PATCH)` 的**快捷方式**。

### 23. `@PathVariable`
*   **作用**：将URL中的**路径变量**绑定到方法参数上。
    ```java
    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) { ... }
    ```

### 24. `@RequestParam`
*   **作用**：将**查询参数**（Query Parameter）或**表单参数**（Form Data）绑定到方法参数上。
    ```java
    @GetMapping("/search")
    public List<User> search(@RequestParam String keyword) { ... }
    ```

### 25. `@RequestBody`
*   **作用**：将**HTTP请求体**（Request Body）中的JSON或XML数据**反序列化**为Java对象。
    ```java
    @PostMapping("/users")
    public User createUser(@RequestBody User user) { ... }
    ```

### 26. `@ResponseBody`
*   **作用**：将方法的返回值**序列化**为JSON或XML，并写入HTTP响应体。`@RestController`已包含此功能。

### 27. `@ResponseStatus`
*   **作用**：指定方法处理完请求后返回的**HTTP状态码**。
    ```java
    @ResponseStatus(HttpStatus.CREATED)
    @PostMapping("/users")
    public void createUser(...) { ... }
    ```

### 28. `@CrossOrigin`
*   **作用**：为控制器或方法开启**跨域资源共享**（CORS）支持，解决前端跨域请求问题。

### 29. `@ExceptionHandler`
*   **作用**：用于处理控制器中抛出的**特定异常**，可以自定义错误响应。

### 30. `@ControllerAdvice`
*   **作用**：`@Component`的特化版，配合`@ExceptionHandler`，可以创建**全局的异常处理类**，对所有控制器生效。

### 31. `@InitBinder`
*   **作用**：用于注册自定义的**数据绑定器**，例如对日期字符串进行格式化。

### 32. `@ModelAttribute`
*   **作用**：可以将方法的返回值添加到**Model**中，供视图使用；也可以用于将请求参数绑定到命令对象。

### 33. `@CookieValue`
*   **作用**：将HTTP请求中的**Cookie值**绑定到方法参数。

### 34. `@RequestHeader`
*   **作用**：将HTTP请求中的**Header值**绑定到方法参数。

### 35. `@SessionAttribute`
*   **作用**：访问**HTTP Session**中存储的属性。

### 36. `@MatrixVariable`
*   **作用**：处理URL中的**矩阵变量**（一种不太常用的参数传递方式）。

---

## 💾 第三部分：数据持久化 - 简化数据库操作

让数据库交互变得无比简单。

### 37. `@Entity`
*   **作用**：(JPA) 标记一个类为**实体类**，对应数据库中的一张表。

### 38. `@Table`
*   **作用**：(JPA) 指定实体类对应的**数据库表名**。

### 39. `@Id`
*   **作用**：(JPA) 标记实体类的**主键**字段。

### 40. `@GeneratedValue`
*   **作用**：(JPA) 指定主键的**生成策略**（如自增、UUID等）。

### 41. `@Column`
*   **作用**：(JPA) 指定实体字段对应的**数据库列名**及属性（如长度、是否可为空等）。

### 42. `@Transient`
*   **作用**：(JPA) 标记一个字段**不持久化**到数据库。

### 43. `@Repository`
*   **作用**：(Spring) 如前所述，用于数据访问层，提供异常转换。

### 44. `@Mapper`
*   **作用**：(MyBatis) 标记一个接口为**MyBatis的Mapper接口**。

### 45. `@Select`, `@Insert`, `@Update`, `@Delete`
*   **作用**：(MyBatis) 在Mapper接口的方法上直接编写SQL语句。

### 46. `@Param`
*   **作用**：(MyBatis) 为Mapper方法的参数命名，以便在SQL中引用。

### 47. `@Transactional`
*   **作用**：(Spring) 声明式事务管理。标记在方法或类上，确保方法内的数据库操作在一个事务中执行。

### 48. `@Modifying`
*   **作用**：(Spring Data JPA) 用于标记**更新、删除**等修改数据的查询方法。

### 49. `@Query`
*   **作用**：(Spring Data JPA) 允许在Repository方法上编写自定义的JPQL或原生SQL查询。

### 50. `@EnableJpaRepositories`
*   **作用**：启用Spring Data JPA的**Repository自动发现**功能。

---

## ⚙️ 第四部分：高级配置 - 条件化与外部化

实现灵活、可配置的应用。

### 51. `@EnableAutoConfiguration`
*   **作用**：开启Spring Boot的**自动配置**机制。`@SpringBootApplication`已包含。

### 52. `@ConditionalOnClass`
*   **作用**：当**classpath下存在**某个类时，才创建被注解的Bean或配置。

### 53. `@ConditionalOnMissingClass`
*   **作用**：当**classpath下不存在**某个类时，才创建被注解的Bean或配置。

### 54. `@ConditionalOnBean`
*   **作用**：当容器中**存在**某个Bean时，才创建被注解的Bean。

### 55. `@ConditionalOnMissingBean`
*   **作用**：当容器中**不存在**某个Bean时，才创建被注解的Bean。这是很多Starter实现自定义覆盖的关键。

### 56. `@ConditionalOnProperty`
*   **作用**：当**配置文件**（application.properties/yml）中存在某个属性且值匹配时，才生效。
    ```java
    @Bean
    @ConditionalOnProperty(name = "feature.pay.enabled", havingValue = "true")
    public PaymentService paymentService() { ... }
    ```

### 57. `@ConditionalOnResource`
*   **作用**：当**classpath下存在**某个资源文件时，才生效。

### 58. `@ConditionalOnWebApplication`
*   **作用**：当应用是一个**Web应用**时，才生效。

### 59. `@ConditionalOnNotWebApplication`
*   **作用**：当应用**不是一个Web应用**时，才生效。

### 60. `@Conditional`
*   **作用**：最通用的条件注解，可以自定义复杂的判断逻辑。

### 61. `@Value`
*   **作用**：将**配置文件**中的属性值注入到字段中。
    ```java
    @Value("${app.name}")
    private String appName;
    ```

### 62. `@ConfigurationProperties`
*   **作用**：将一组相关的配置属性**批量绑定**到一个Java Bean上，比`@Value`更强大、类型安全。
    ```java
    @ConfigurationProperties(prefix = "database")
    @Component
    public class DatabaseProperties {
        private String url;
        private String username;
        // getters and setters
    }
    ```

### 63. `@EnableConfigurationProperties`
*   **作用**：在配置类上使用，以启用`@ConfigurationProperties`注解的类。

### 64. `@Profile`
*   **作用**：指定Bean或配置类只在**特定的环境**（Profile）下生效，如`dev`, `test`, `prod`。

### 65. `@Import`
*   **作用**：导入其他的**配置类**或`ImportSelector`/`ImportBeanDefinitionRegistrar`实现。

### 66. `@PropertySource`
*   **作用**：加载额外的**属性文件**。

### 67. `@EnableScheduling`
*   **作用**：开启**定时任务**支持。

### 68. `@Scheduled`
*   **作用**：标记一个方法为**定时任务**，通过`cron`, `fixedRate`等属性配置执行计划。

### 69. `@Async`
*   **作用**：标记一个方法为**异步执行**。需要配合`@EnableAsync`使用。

### 70. `@EnableAsync`
*   **作用**：开启**异步方法**执行的支持。

---

## 🔒 第五部分：安全与缓存 - 提升应用健壮性

### 71. `@EnableWebSecurity`
*   **作用**：(Spring Security) 开启Web安全配置。

### 72. `@EnableGlobalMethodSecurity`
*   **作用**：(Spring Security) 开启**方法级别的安全控制**。

### 73. `@PreAuthorize`
*   **作用**：(Spring Security) 在方法执行**前**进行权限检查。
    ```java
    @PreAuthorize("hasRole('ADMIN')")
    public void deleteUser(Long id) { ... }
    ```

### 74. `@PostAuthorize`
*   **作用**：(Spring Security) 在方法执行**后**进行权限检查。

### 75. `@Cacheable`
*   **作用**：(Spring Cache) 将方法的返回值**缓存**起来。下次调用相同参数的方法时，直接从缓存返回，不再执行方法体。
    ```java
    @Cacheable("users")
    public User getUserById(Long id) {
        // 复杂的数据库查询
    }
    ```

### 76. `@CachePut`
*   **作用**：(Spring Cache) **更新**缓存。方法总会被执行，其返回值会放入缓存。

### 77. `@CacheEvict`
*   **作用**：(Spring Cache) **清除**缓存。
    ```java
    @CacheEvict(value = "users", allEntries = true)
    public void clearUserCache() { ... }
    ```

### 78. `@EnableCaching`
*   **作用**：(Spring Cache) 开启**缓存**支持。

---

## 🧪 第六部分：测试验证 - 保障代码质量

### 79. `@SpringBootTest`
*   **作用**：用于**集成测试**，会加载完整的Spring Boot应用上下文。

### 80. `@WebMvcTest`
*   **作用**：用于**Web层**的切片测试，只加载Web相关的组件（如`@Controller`），速度快。

### 81. `@DataJpaTest`
*   **作用**：用于**数据访问层**的切片测试，只加载JPA相关的组件和内存数据库。

### 82. `@JsonTest`
*   **作用**：用于**JSON序列化/反序列化**的测试。

### 83. `@TestConfiguration`
*   **作用**：在测试中定义**特殊的配置**，用于覆盖生产配置。

### 84. `@MockBean`
*   **作用**：在Spring上下文中创建一个**Mockito Mock对象**，用于替换真实的Bean，方便单元测试。

### 85. `@SpyBean`
*   **作用**：在Spring上下文中创建一个**Mockito Spy对象**，部分方法调用真实实现，部分可以Mock。

### 86. `@ActiveProfiles`
*   **作用**：在测试中**激活特定的Profile**。

### 87. `@TestPropertySource`
*   **作用**：为测试**加载特定的属性文件**或设置属性。

### 88. `@AutoConfigureTestDatabase`
*   **作用**：(Spring Boot Test) 控制测试中使用的**数据库**（如使用内存数据库H2）。

### 89. `@DirtiesContext`
*   **作用**：标记测试会**污染**应用上下文，Spring会在测试后重新加载上下文。

---

## 🧩 第七部分：其他实用注解

### 90. `@Valid` / `@Validated`
*   **作用**：触发**Bean Validation**（JSR-303/380），对方法参数或返回值进行校验。
    ```java
    public User createUser(@Valid @RequestBody User user) { ... }
    ```

### 91. `@NotNull`, `@NotBlank`, `@Size`, `@Email`...
*   **作用**：具体的**校验约束**注解。

### 92. `@EventListener`
*   **作用**：标记一个方法为**事件监听器**，用于处理Spring的`ApplicationEvent`。

### 93. `@Order`
*   **作用**：定义Bean、拦截器、监听器等的**执行顺序**。

### 94. `@AliasFor`
*   **作用**：用于在**自定义组合注解**中，为属性创建别名。

### 95. `@Indexed`
*   **作用**：(Spring 5.3+) 在编译时为组件生成索引，**加速**组件扫描。

### 96. `@ServletComponentScan`
*   **作用**：(Spring Boot) 扫描`@WebServlet`, `@WebFilter`, `@WebListener`等Servlet组件。

### 97. `@EnableTransactionManagement`
*   **作用**：(Spring) 开启**注解驱动的事务管理**。`@SpringBootApplication`通常已自动配置。

### 98. `@Retryable`
*   **作用**：(Spring Retry) 标记一个方法在失败时可以**自动重试**。

### 99. `@EnableRetry`
*   **作用**：(Spring Retry) 开启**重试**功能。

### 100. `@RefreshScope`
*   **作用**：(Spring Cloud) 标记一个Bean为**可刷新**的。当配置中心的配置发生变化时，该Bean会被重新创建以获取最新配置。

---

## 💎 总结

这100个注解构成了Spring Boot开发的完整生态。它们各司其职，共同打造了Spring Boot **“约定优于配置”** 和 **“开箱即用”** 的卓越体验。

*   **新手**：从第一部分和第二部分开始，掌握`@SpringBootApplication`, `@RestController`, `@Autowired`等核心注解，你就能快速上手开发。
*   **进阶者**：深入理解第三、四、五部分的注解，能让你构建出更健壮、更灵活、更高性能的应用。
*   **专家**：熟练运用第六、七部分的注解，可以极大地提升开发效率和代码质量。

**记住，真正的高手不是记住所有注解，而是知道在何时、何地、为何使用哪个注解。** 希望这份清单能成为你Spring Boot之旅中的得力助手！

💡 导语： 在Spring Boot的世界里，注解（Annotation）是开发者最强大的武器。它用简洁的代码替代了繁琐的XML配置，让开发变得“开箱即用”。但面对海量的注解，你是否感到眼花缭乱？哪些是核心必备？哪些是进阶利器？

SpringBoot注解大全：100个从入门到精通，一篇全掌握！（建议收藏）

后端

编程语言

开发工具

SpringBoot注解大全：100个核心注解详解，涵盖项目启动、Web开发、数据访问、安全控制等全场景。从@SpringBootApplication基础注解到@Retryable高级功能，助你快速掌握SpringBoot开发精髓，提升开发效率与代码质量。适合各阶段开发者使用的终极速查手册。

单元测试

集成测试

Spring Boot

数据库

容器

JSON

Java

2026采购季 | AI焕新·智启新局

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

SpringBoot注解大全：100个从入门到精通，一篇全掌握！（建议收藏）-腾讯云开发者社区-腾讯云

SpringBoot注解大全：100个从入门到精通，一篇全掌握！（建议收藏）

SpringBoot注解大全：100个从入门到精通，一篇全掌握！（建议收藏）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐