在 Spring Boot Web 后端开发中,注解(Annotation)扮演着核心角色,它们极大地简化了配置、依赖管理、请求映射及数据持久化等流程。本文将按功能分类,梳理常用注解的作用、用法与典型场景,并辅以代码示例,助你全面掌握并灵活运用。
1. 核心启动与配置注解
| 注解 | 作用 | 用法 | 场景 |
|---|---|---|---|
@SpringBootApplication | 标记主启动类,组合了 @Configuration、@EnableAutoConfiguration、@ComponentScan。 | 加在启动类上。 | Spring Boot 应用的入口。 |
@Configuration | 声明一个类为配置类,可包含 @Bean 方法。 | 加在类上。 | 定义额外的配置 Bean。 |
@EnableAutoConfiguration | 开启 Spring Boot 自动配置,根据依赖自动配置 Bean。 | 通常由 @SpringBootApplication 组合。 | 自动配置场景。 |
@ComponentScan | 定义组件扫描路径,默认扫描当前包及其子包。 | 加在配置类上,可指定 basePackages。 | 扫描 @Component、@Service 等注解的类。 |
@PropertySource | 指定属性文件加载到 Spring Environment。 | 加在配置类上,指定文件位置。 | 加载自定义配置文件。 |
@Value | 注入配置文件中的属性值。 | 加在字段、方法参数或方法上。 | 从 application.properties 或自定义配置中取值。 |
@ConfigurationProperties | 将配置文件中的属性绑定到 Java Bean 上。 | 加在类上,需配合 @EnableConfigurationProperties 或 @Component 使用。 | 批量绑定配置属性。 |
@Import | 导入一个或多个配置类。 | 加在配置类上。 | 组合多个配置类。 |
@ImportResource | 导入 XML 配置文件。 | 加在配置类上,指定 XML 路径。 | 整合旧版 XML 配置。 |
2. 控制器与请求映射注解
这部分注解主要用于处理 HTTP 请求,是构建 RESTful API 的基础。
| 注解 | 作用 | 用法 | 场景 |
|---|---|---|---|
@Controller | 标记一个类为 Spring MVC 控制器,通常返回视图。 | 加在类上。 | 传统 MVC 应用,返回页面。 |


