SpringBoot常用注解有哪些？一文详解核心注解与实战应用

数码系统

相机 win10

测评 win11

手机智车

华为 Tesla

小米理想

苹果蔚来

游戏软件

LOL 抖音

原神微信

当前位置：首页

编程语言

SpringBoot常用注解有哪些？一文详解核心注解与实战应用

热心网友时间：2026-07-21

转载

SpringBoot框架的注解体系主要包括@Configuration用于定义配置类，@SpringBootApplication复合注解用以实现自动配置与组件扫描，@RestController用于处理HTTP请求并返回JSON格式数据，@Service和@Component分别用于标注业务层与通用组件。掌握这些核心注解即可应对日常开发场景。

SpringBoot常用注解及其应用

在实际开发中，Spring Boot的注解体系堪称项目的“骨架说明书”——正确使用可大幅提升效率，错误使用则可能带来调试困难。以下表格系统梳理了从配置到控制器的核心注解，便于快速查阅与实战应用，建议收藏对照。

SpringBoot常用注解有哪些？详解核心注解及实战应用

如下所示

注解名称	作用	备注
@Configuration	自Spring 3.0起，@Configuration用于定义配置类，可替代XML配置文件。标注了该注解的类内部包含一个或多个被@Bean注解的方法，这些方法会被AnnotationConfigApplicationContext或AnnotationConfigWebApplicationContext扫描，并用于构建Bean定义、初始化Spring容器。	该注解的配置类有如下要求：1、不能是匿名类；2、不能是final类型；3、必须是静态类。
@SpringBootApplication	@SpringBootApplication是一个复合注解，包含@ComponentScan（自动扫描包）、@SpringBootConfiguration（标志当前类为配置类）、@EnableAutoConfiguration（开启Spring Boot自动配置机制）。	如果该包或其上级包使用了@SpringBootApplication（已包含@ComponentScan、@Configuration、@EnableAutoConfiguration），则无需手动添加这些注解；否则需手动添加所需注解。
@ComponentScan	@ComponentScan的作用是告知Spring在哪里查找Bean，实现自动扫描并发现可配置使用的Bean。	如果该包或其上级包使用了@SpringBootApplication（已包含@ComponentScan、@Configuration、@EnableAutoConfiguration），则无需手动添加@ComponentScan；否则需手动添加并指定Bean所在的包。
@SpringBootConfiguration	标志当前类为配置类，继承自@Configuration且作用一致。该注解会将类内声明的一个或多个以@Bean注解标记的方法的实例纳入Spring容器，实例名即为方法名。	如果该包或其上级包使用了@SpringBootApplication（已包含@ComponentScan、@Configuration、@EnableAutoConfiguration），则无需手动添加@SpringBootConfiguration；否则需手动添加。
@EnableAutoConfiguration	开启Spring Boot的自动配置机制，加载应用程序所需的所有Bean。	如果该包或其上级包使用了@SpringBootApplication（已包含@ComponentScan、@Configuration、@EnableAutoConfiguration），则无需手动添加@EnableAutoConfiguration；否则需手动添加。
@Autowired	使用@Autowired进行自动注入时，Spring容器中匹配的候选Bean数目必须有且仅有一个。若找不到匹配的Bean，Spring容器将抛出BeanCreationException异常，并提示至少需要一个匹配的Bean。	@Autowired可作用于构造器、方法、参数、属性，作用位置不同，作用范围也不同。
@RestController	@RestController是Spring 4引入的新注解，将类标记为控制器，其中每个方法都返回一个域对象而非视图。它是@Controller和@ResponseBody的缩写。	如果类上添加了@RestController，则不能再添加@Controller或@ResponseBody注解，否则会报错。
@Controller	@Controller的作用是将用户提交的请求通过URL匹配分配给不同的处理器，进行处理后向用户返回结果。其核心在于从HTTP请求中获取信息、提取参数，并分发给不同的处理服务。	一般配合@RequestMapping使用。如果类上添加了@RestController，则方法上不能再添加@Controller或@ResponseBody注解，否则会报错。
@RequestMapping	通过该注解映射到Controller层的指定URL。	@RequestMapping分为类级别和方法级别两种。
@ResponseBody	@ResponseBody通常作用于方法上，表示该方法的返回结果直接写入HTTP Response Body中，常用于AJAX异步请求（返回JSON或XML格式）。	使用该注解后，不会经过ViewResolver，直接返回数据。
@RequestBody	@RequestBody常用来处理Content-Type不是默认的application/x-www-form-urlencoded编码的内容，例如application/json或application/xml。一般情况下，常用于处理application/json类型的数据。	前端JSON字符串中的key必须对应User中的属性名，否则请求无法映射。
@PathVariable	绑定函数中的参数，用于获取URL中的参数值。	默认情况下，Spring会对@PathVariable注解的变量自动赋值，也可指定@PathVariable使用哪一个URL中的变量，例如@PathVariable("uname") String username。
@Service	标注该类为业务层组件。	添加在实现类上。
@Component	将普通Bean实例化到Spring容器中。	使用该类时，必须将其放入Spring容器中，否则会找不到该Bean。

总结

Spring Boot的注解体系看似庞大，但核心逻辑十分清晰：配置类负责定义Bean，自动配置机制智能推断所需依赖，控制器处理请求，Service和Component承载业务逻辑。掌握这些关键注解，即可应对大部分日常开发场景。当然，实际项目中还会遇到@Async、@Transactional、@Conditional等进阶注解，这将是另一个值得深入探讨的话题。

来源:https://www.jb51.net/program/367740zi0.htm

上一篇： Java内存模型与happens-before规则最新详解：从JSR-133到并发编程

下一篇： Java正则表达式模式与匹配器一文搞懂详细教程