Spring 生态系统庞大而丰富，其注解体系主要分为两大块：**Spring Framework 核心注解** 和 **Spring Boot 特有注解**。简单来说，**Spring Boot 是构建在 Spring Framework 之上的**，因此它包含了所有 Spring Framework 的注解，并在此基础上增加了大量用于简化配置和自动化的注解。

下面为你系统梳理这两大类中最常用、最重要的注解：

---

## 🧱 第一部分：Spring Framework 核心注解

这些是 Spring 框架的基石，无论是否使用 Spring Boot，只要用 Spring，就会接触到它们。

### **1. Bean 管理与依赖注入 (DI)**
这是 Spring IoC 容器的核心功能。
*   `@Component`: 通用组件注解，标记一个类为 Spring Bean。
*   `@Service`: `@Component` 的特化，用于业务逻辑层。
*   `@Repository`: `@Component` 的特化，用于数据访问层，提供异常转换。
*   `@Controller`: `@Component` 的特化，用于 Spring MVC 控制器。
*   `@Configuration`: 声明一个类为配置类（Java Config）。
*   `@Bean`: 在配置类的方法上使用，将方法返回值注册为 Bean。
*   `@Autowired`: 自动装配依赖。可以用于字段、构造函数、Setter 方法。
*   `@Qualifier`: 当存在多个同类型 Bean 时，配合 `@Autowired` 指定具体要注入的 Bean 名称。
*   `@Primary`: 当存在多个同类型 Bean 时，标记一个为首选 Bean。
*   `@Scope`: 定义 Bean 的作用域（如 `singleton`, `prototype`）。
*   `@PostConstruct`: 标记初始化方法，在依赖注入完成后执行。
*   `@PreDestroy`: 标记销毁方法，在 Bean 销毁前执行。
*   `@Resource` (JSR-250): Java 标准注解，功能类似 `@Autowired` + `@Qualifier`。
*   `@Inject` (JSR-330): Java 标准注解，功能类似 `@Autowired`。

### **2. Spring Web MVC (构建 Web 应用)**
*   `@RequestMapping`: 通用请求映射注解，可指定 URL、HTTP 方法等。
*   `@GetMapping`, `@PostMapping`, `@PutMapping`, `@DeleteMapping`, `@PatchMapping`: `@RequestMapping` 的快捷方式，分别对应不同的 HTTP 方法。
*   `@PathVariable`: 绑定 URL 路径中的变量到方法参数。
*   `@RequestParam`: 绑定请求参数（Query String 或 Form Data）到方法参数。
*   `@RequestBody`: 将 HTTP 请求体（通常是 JSON）反序列化为 Java 对象。
*   `@ResponseBody`: 将方法返回值序列化为 HTTP 响应体（通常是 JSON）。`@RestController` 已包含此注解。
*   `@RestController`: `@Controller` + `@ResponseBody` 的组合，用于构建 RESTful API。
*   `@ExceptionHandler`: 处理控制器中抛出的特定异常。
*   `@ControllerAdvice`: 全局异常处理、数据绑定等的切面。
*   `@CrossOrigin`: 开启跨域支持。

### **3. 数据访问与事务管理**
*   `@Transactional`: 声明式事务管理，确保方法在事务中执行。

### **4. AOP (面向切面编程)**
*   `@Aspect`: 声明一个切面类。
*   `@Before`, `@After`, `@Around`, `@AfterReturning`, `@AfterThrowing`: 定义不同类型的通知（Advice）。

---

## ⚙️ 第二部分：Spring Boot 特有注解

这些注解极大地简化了 Spring 应用的配置和启动过程，是“约定优于配置”理念的体现。

### **1. 应用启动与自动配置**
*   `@SpringBootApplication`: **最核心的注解**！它是以下三个注解的组合：
    *   `@SpringBootConfiguration`: 等同于 `@Configuration`。
    *   `@EnableAutoConfiguration`: **开启自动配置**。Spring Boot 会根据 classpath 下的依赖自动配置相应的 Bean。
    *   `@ComponentScan`: 自动扫描启动类所在包及其子包下的组件。
*   `@EnableAutoConfiguration`: 单独使用以开启自动配置（通常被 `@SpringBootApplication` 包含）。

### **2. 条件化配置 (Conditional Configuration)**
这是 Spring Boot 自动配置能智能工作的关键，只在满足特定条件时才创建 Bean。
*   `@ConditionalOnClass`: 当 classpath 下存在某个类时生效。
*   `@ConditionalOnMissingClass`: 当 classpath 下不存在某个类时生效。
*   `@ConditionalOnBean`: 当容器中存在某个 Bean 时生效。
*   `@ConditionalOnMissingBean`: 当容器中不存在某个 Bean 时生效（常用于提供默认实现）。
*   `@ConditionalOnProperty`: 当配置文件 (`application.properties/yml`) 中存在某个属性且值匹配时生效。
*   `@ConditionalOnWebApplication`: 当应用是 Web 应用时生效。
*   `@ConditionalOnNotWebApplication`: 当应用不是 Web 应用时生效。
*   `@Conditional`: 最通用的条件注解，可自定义复杂的判断逻辑。

### **3. 配置属性绑定**
*   `@ConfigurationProperties`: 将配置文件中的一组相关属性批量绑定到一个 Java Bean 上，类型安全且功能强大。
*   `@EnableConfigurationProperties`: 在配置类上启用 `@ConfigurationProperties` 注解的类。

### **4. 其他实用功能**
*   `@Profile`: 指定 Bean 或配置只在特定的环境（如 `dev`, `test`, `prod`）下激活。
*   `@EnableScheduling`: 开启定时任务支持。
*   `@Scheduled`: 标记一个方法为定时任务。
*   `@EnableAsync`: 开启异步方法支持。
*   `@Async`: 标记一个方法为异步执行。

---

## 💎 总结

*   **Spring Framework 注解** 是基础，负责 **IoC、DI、AOP、Web MVC** 等核心功能。
*   **Spring Boot 注解** 是增强，通过 **自动配置、条件化、外部化配置** 等机制，极大地简化了基于 Spring Framework 的应用开发。

当你看到一个 Spring Boot 项目时，你会同时看到这两类注解的身影。理解它们的区别和联系，是掌握 Spring Boot 开发的关键。

Spring 生态系统庞大而丰富，其注解体系主要分为两大块：Spring Framework 核心注解 和 Spring Boot 特有注解。简单来说，Spring Boot 是构建在 Spring Framework 之上的，因此它包含了所有 Spring Framework 的注解，并在此基础上增加了大量用于简化配置和自动化的注解。

Spring Boot 常用注解

后端

开发工具

Spring注解体系分为核心注解与Boot特有注解。核心注解包括@Component、@Autowired等IoC/DI注解，@RequestMapping等WebMVC注解。Boot特有注解如@SpringBootApplication实现自动配置，@Conditional系列实现条件化配置。掌握这些注解能高效开发Spring应用。

容器

JSON

Java

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

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

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

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

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

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

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

社区新版编辑器体验调研

Spring注解体系分为核心注解与Boot特有注解。核心注解包括@Component、@Autowired等IoC/DI注解，@RequestMapping等WebMVC注解。Boot特有注解如@SpringBootApplication实现自动配置，@Conditional系列实现条件化配置。掌握这些注解能高效开发S...

Spring Boot 常用注解-腾讯云开发者社区-腾讯云

Spring Boot 常用注解

Spring Boot 常用注解

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐