在 Spring 和 Spring Boot 框架中，有许多核心注解被广泛应用。以下是常用的关键注解分类详解：
一、组件声明与依赖注入
| 注解 | 作用 | 示例 |
|---|---|---|
@Component |
通用组件声明 (Bean 的泛化形式) | @Component public class ServiceImpl {...} |
@Service |
标记服务层（业务逻辑层）组件 | @Service public class UserService {...} |
@Repository |
标记持久层（DAO 层）组件，自动处理数据库异常 | @Repository public class UserDao {...} |
@Controller |
标记 Web 控制器组件 | @Controller public class UserCtrl {...} |
@RestController |
@Controller + @ResponseBody（REST API 专用） |
@RestController public class ApiCtrl {...} |
@Autowired |
自动按类型依赖注入 | @Autowired private UserService service; |
@Qualifier |
按名称指定注入的 Bean | @Qualifier("mainDB") DataSource ds; |
@Resource |
JSR-250 标准注入（按名称） | @Resource(name="slaveDB") DataSource ds; |
二、配置与属性管理
| 注解 | 作用 |
|---|---|
@Configuration |
声明配置类（替代 XML 配置） |
@Bean |
声明方法返回对象作为 Spring Bean |
@Value |
注入外部配置值 （${property.key}） |
@ConfigurationProperties |
批量绑定配置文件到 POJO （比 @Value 更结构化） |
@PropertySource |
加载自定义 properties 文件 |
@EnableConfigurationProperties |
启用配置属性绑定 |
三、Web 与请求处理
| 注解 | HTTP 方法 | 作用 |
|---|---|---|
@RequestMapping |
通用映射 | 类/方法级别的请求映射 |
@GetMapping |
GET | 简化版 GET 请求映射 |
@PostMapping |
POST | 简化版 POST 请求映射 |
@PutMapping |
PUT | 简化版 PUT 请求映射 |
@DeleteMapping |
DELETE | 简化版 DELETE 请求映射 |
@PatchMapping |
PATCH | 简化版 PATCH 请求映射 |
@RequestParam |
- | 获取 URL 查询参数 |
@PathVariable |
- | 获取 URL 路径变量 |
@RequestBody |
- | 接收 HTTP 请求体（如 JSON） |
@ResponseBody |
- | 直接返回数据（非视图） |
@CookieValue |
- | 获取 Cookie 值 |
@SessionAttribute |
- | 访问会话属性 |
四、事务管理
| 注解 | 作用 |
|---|---|
@Transactional |
声明式事务管理（类/方法级） |
@EnableTransactionManagement |
在配置类启用注解驱动的事务管理 |
五、测试相关
| 注解 | 作用 |
|---|---|
@SpringBootTest |
启动完整的 Spring Boot 测试环境 |
@WebMvcTest |
专注于 MVC 控制器的测试（不加载完整上下文） |
@DataJpaTest |
专注于 JPA 测试（使用内存数据库） |
@MockBean |
在测试上下文中注入 Mock 对象 |
@Test |
标记测试方法（JUnit） |
六、AOP 面向切面编程
| 注解 | 作用 |
|---|---|
@Aspect |
声明切面类 |
@Before |
方法执行前切入 |
@After |
方法执行后切入（无论是否异常） |
@AfterReturning |
方法正常返回后切入 |
@AfterThrowing |
方法抛出异常后切入 |
@Around |
环绕增强（最强大的通知类型） |
@Pointcut |
定义可重用的切入点表达式 |
七、条件化配置 (Spring Boot)
| 注解 | 作用 |
|---|---|
@ConditionalOnProperty |
当配置属性存在且匹配时生效 |
@ConditionalOnBean |
当指定 Bean 存在时生效 |
@ConditionalOnMissingBean |
当指定 Bean 不存在时生效 |
@ConditionalOnClass |
当指定类在 classpath 存在时生效 |
@ConditionalOnWebApplication |
当是 Web 应用时生效 |
八、调度与异步
| 注解 | 作用 |
|---|---|
@Scheduled |
定时任务调度（支持 cron 表达式） |
@EnableScheduling |
启用定时任务支持 |
@Async |
异步执行方法 |
@EnableAsync |
启用异步执行支持 |
九、缓存管理
| 注解 | 作用 |
|---|---|
@Cacheable |
缓存方法结果 |
@CachePut |
更新缓存 |
@CacheEvict |
清除缓存 |
@EnableCaching |
启用缓存注解支持 |
十、其他实用注解
| 注解 | 作用 |
|---|---|
@Lazy |
延迟初始化 Bean |
@Primary |
指定同类型 Bean 的优先注入选项 |
@Scope |
定义 Bean 作用域（singleton, prototype 等） |
@Profile |
按环境激活配置（dev, test, prod） |
@Valid |
触发 JSR-303 Bean 校验（配合 @NotNull 等） |
📌 最佳实践建议：
- 优先使用
@ConfigurationProperties替代分散的@Value- REST API 开发首选
@RestController+ HTTP 方法注解- 数据库操作使用
@Transactional确保事务完整性- 生产环境配置
@Profile("prod")分离环境参数
这些注解共同构成了 Spring 生态的基石，通过声明式编程极大简化了企业级应用开发。掌握它们是高效使用 Spring 框架的关键。