Spring Boot Web 后端开发：核心注解实战指南

3. 依赖注入与组件注册注解

Spring 的核心是 IoC 容器，依赖注入注解让对象间的耦合度降低。@Service、@Repository 和 @Component 分别标识业务层、数据访问层和通用组件。虽然它们本质都是 @Component，但语义化标注有助于分层架构的维护。

注入方式上，推荐使用构造器注入而非字段注入，这样便于测试且不可变。@Autowired 按类型装配，若存在多个同类型 Bean，需配合 @Qualifier 指定名称。Java 标准注解如 @Resource 和 @Inject 也可作为替代方案。

4. 数据访问（JPA / Spring Data）注解

使用 JPA 进行 ORM 映射时，注解定义了实体与数据库表的对应关系。@Entity 标记实体类，@Id 定义主键，@Column 控制列属性。关联关系通过 @OneToOne、@OneToMany 等注解描述，@JoinTable 则用于多对多关系的中间表配置。

对于复杂查询，@Query 允许编写 JPQL 或 SQL，配合 @Param 命名参数。@Transactional 虽常用于事务管理，但在 Repository 层也常用来标记需要事务支持的方法。

5. 事务管理注解

事务一致性是后端系统的基石。@Transactional 是声明式事务管理的核心，可配置传播行为、隔离级别和超时时间。通常建议加在 Service 层方法上，确保业务逻辑原子性。注意，该注解基于 AOP 实现，自调用会导致失效。

6. 缓存注解

引入缓存能显著减少数据库压力。开启缓存需先使用 @EnableCaching。@Cacheable 优先查缓存，@CachePut 强制更新缓存，@CacheEvict 清除缓存。这三者配合使用，可覆盖读多写少、更新及删除场景。

7. 异步与定时任务注解

非阻塞任务适合异步处理。@EnableAsync 开启异步支持，@Async 标注耗时方法（如发送邮件）。定时任务方面，@EnableScheduling 配合 @Scheduled 可实现 Cron 表达式调度，适用于数据清理或报表生成。

8. 异常处理与控制器增强

全局异常处理能提升用户体验。@ControllerAdvice 定义全局增强，结合 @ExceptionHandler 捕获特定异常。RESTful 风格下，@RestControllerAdvice 更常用，可直接返回错误 JSON 结构。@InitBinder 则用于自定义数据绑定规则，如日期格式化。

9. 跨域支持注解

前后端分离项目常遇跨域问题。@CrossOrigin 可加在类或方法上，指定允许的来源域名、方法和头信息，快速解决 CORS 限制。

10. 条件化配置注解

自动配置背后依赖条件注解。@ConditionalOnClass 检测类路径，@ConditionalOnProperty 检查配置项。这些注解让框架具备弹性，仅在必要时加载特定 Bean，避免资源浪费。

11. 测试注解

单元测试和集成测试离不开特定注解。@SpringBootTest 加载完整上下文，@WebMvcTest 仅测 Controller，@DataJpaTest 专注 Repository。配合 @MockBean 模拟依赖，可快速隔离测试环境。

12. Lombok 常用注解

Lombok 大幅减少样板代码。@Data 自动生成 Getter/Setter/ToString，@Builder 实现建造者模式，@Slf4j 注入日志对象。合理使用可保持代码简洁，但需注意编译期依赖。

13. Spring Security 常用注解

安全控制是生产环境的刚需。@EnableWebSecurity 启用安全配置，@PreAuthorize 支持 SpEL 表达式进行方法级权限校验。@AuthenticationPrincipal 方便获取当前登录用户信息。

14. 其他常用注解

还有一些辅助注解值得留意。@Profile 区分环境配置，@EventListener 监听应用事件，@Bean 手动注册第三方库实例。这些注解丰富了 Spring 生态的扩展能力。

以上涵盖了 Spring Boot Web 后端开发中绝大多数常用注解。实际项目中，根据业务需求灵活组合，往往比死记硬背更有效。