当前位置：首页 > news >正文

Spring Boot常用注解深度解析：从入门到精通

news 2025/7/3 17:22:42

今天，这篇文章带你将深入理解Spring Boot中30+常用注解，通过代码示例和关系图，帮助你彻底掌握Spring核心注解的使用场景和内在联系。

一、启动类与核心注解

1.1 @SpringBootApplication

组合注解：

@SpringBootApplication = @Configuration + @EnableAutoConfiguration +@ComponentScan

@SpringBootApplication
public class MyApplication {public static void main(String[] args) {SpringApplication.run(MyApplication.class, args);}
}

三个核心功能：

@Configuration：声明配置类

@EnableAutoConfiguration：启用自动配置

@ComponentScan：组件扫描（默认扫描启动类所在包及其子包）

二、配置与Bean管理

2.1 @Configuration

声明配置类，内部包含多个@Bean方法

@Configuration
public class AppConfig {@Beanpublic DataSource dataSource() {return new HikariDataSource();}
}

2.2 @Bean vs @Component

特性	@Bean	@Component
声明位置	配置类方法	类级别
控制粒度	第三方库类	自己编写的类
依赖注入	方法参数自动注入	字段/构造器

2.3 @Scope Bean作用域

@Bean
@Scope("prototype")
public Service prototypeService() {return new Service();
}

三、依赖注入（DI）

3.1 @Autowired

自动注入的三种方式：

// 构造器注入（推荐）
@Autowired
public MyController(MyService service) {this.service = service;
}// Setter注入
@Autowired
public void setService(MyService service) {this.service = service;
}// 字段注入（不推荐）
@Autowired
private MyService service;

3.2 @Qualifier

解决多个同类型Bean的冲突

@Autowired
@Qualifier("mainService")
private Service service;

3.3 @Primary

设置首选Bean

@Bean
@Primary
public Service primaryService() {return new PrimaryService();
}

四、组件扫描与分层架构

4.1 分层注解

@Service
public class UserService {// 业务逻辑
}@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserService userService;
}

五、Web开发注解

5.1 请求映射

@GetMapping("/{id}")
public User getUser(@PathVariable Long id) {return userService.findById(id);
}@PostMapping
@ResponseStatus(HttpStatus.CREATED)
public User createUser(@RequestBody User user) {return userService.save(user);
}

5.2 参数绑定

@GetMapping
public List<User> searchUsers(@RequestParam(defaultValue = "1") int page,@RequestParam(required = false) String name) {// 分页查询逻辑
}

六、条件装配注解

6.1 @ConditionalOnProperty

@Bean
@ConditionalOnProperty(prefix = "feature",name = "new-payment",havingValue = "true")
public PaymentService newPaymentService() {return new NewPaymentService();
}

6.2 其他条件注解

@ConditionalOnClass：类路径存在指定类时生效

@ConditionalOnMissingBean：容器中不存在指定Bean时生效

七、AOP编程

7.1 切面配置

@Aspect
@Component
public class LoggingAspect {@Pointcut("execution(* com.example.service.*.*(..))")private void serviceLayer() {}@Around("serviceLayer()")public Object logMethod(ProceedingJoinPoint joinPoint) throws Throwable {// 记录方法执行时间long start = System.currentTimeMillis();Object result = joinPoint.proceed();long duration = System.currentTimeMillis() - start;System.out.println(joinPoint.getSignature() + " executed in " + duration + "ms");return result;}
}

八、配置属性绑定

8.1 @ConfigurationProperties

@Configuration
@ConfigurationProperties(prefix = "app")
public class AppConfig {private String name;private int version;private List<String> servers = new ArrayList<>();// getters/setters
}

application.yml配置：

app:name: MyApplicationversion: 2servers:- server1- server2

九、Bean 的生命周期

Spring Boot 中的 Bean 生命周期是理解 Spring 容器管理 Bean 的关键。Bean 的生命周期大致可以分为以下几个阶段：

实例化（Instantiation）：Spring 容器通过调用无参构造方法创建 Bean 实例。

属性赋值（Population）：Spring 容器通过反射将配置文件或注解中定义的属性值注入到 Bean 中。

初始化前处理（Pre-initialization）：

BeanNameAware：如果 Bean 实现了 BeanNameAware 接口，Spring 会调用其 setBeanName 方法，将 Bean 的名称传递给 Bean。

BeanFactoryAware：如果 Bean 实现了 BeanFactoryAware 接口，Spring 会调用其 setBeanFactory 方法，将 BeanFactory 传递给 Bean。

BeanPostProcessor：Spring 会调用 BeanPostProcessor 的 postProcessBeforeInitialization 方法，对 Bean 进行前置处理。

初始化（Initialization）：

InitializingBean：如果 Bean 实现了 InitializingBean 接口，Spring 会调用其 afterPropertiesSet 方法进行初始化。

@PostConstruct：如果 Bean 中有方法使用了 @PostConstruct 注解，Spring 会调用该方法进行初始化。

使用（Usage）：Bean 已经初始化完成，可以被应用程序使用。

销毁前处理（Pre-destruction）：

DisposableBean：如果 Bean 实现了 DisposableBean 接口，Spring 会调用其 destroy 方法进行销毁前的清理工作。

@PreDestroy：如果 Bean 中有方法使用了 @PreDestroy 注解，Spring 会调用该方法进行销毁前的清理工作。

销毁（Destruction）：Spring 容器关闭时，销毁 Bean。

@Component
public class MyBean implements BeanNameAware, BeanFactoryAware, InitializingBean, DisposableBean {private String name;public MyBean() {System.out.println("1. 实例化 Bean");}@Overridepublic void setBeanName(String name) {System.out.println("2. 设置 Bean 名称");}@Overridepublic void setBeanFactory(BeanFactory beanFactory) throws BeansException {System.out.println("3. 设置 BeanFactory");}@Overridepublic void afterPropertiesSet() throws Exception {System.out.println("4. 初始化 Bean");}@Overridepublic void destroy() throws Exception {System.out.println("6. 销毁 Bean");}@PostConstructpublic void init() {System.out.println("5. @PostConstruct 注解的初始化方法");}@PreDestroypublic void preDestroy() {System.out.println("7. @PreDestroy 注解的销毁前方法");}
}