@bean用于在@configuration类中声明第三方bean,支持依赖注入、作用域配置及生命周期管理,方法须public非static,参数自动注入,避免耗时操作。

在 Spring 中,@Bean 注解用于在配置类中显式声明并注册一个 Bean,尤其适合将第三方库中的类(没有 @Component 等注解、也无法修改源码)纳入 Spring 容器管理。
1. 创建配置类并启用组件扫描(可选)
配置类本身需被 Spring 扫描到,通常用 @Configuration 标记。它本质是一个被 Spring 代理的特殊 @Component,所以只要该类在组件扫描路径下,或通过 @Import / Java Config 方式显式引入即可。
例如:
@Configuration
public class ThirdPartyConfig {
// Bean 方法写在这里
}
2. 在配置类中用 @Bean 方法返回第三方实例
每个 @Bean 方法必须是 public 的,返回值类型即为注册的 Bean 类型,方法体中负责创建并返回对象实例。Spring 会自动将其托管,并支持依赖注入、作用域、初始化/销毁回调等。
常见做法包括:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 直接 new 实例(适用于无参构造或简单初始化)
- 调用第三方类的静态工厂方法(如
OkHttpClient.newBuilder()) - 传入其他 Bean 作为参数(Spring 自动注入,支持构造器注入语义)
- 设置属性、调用初始化方法(模拟
@PostConstruct行为)
示例:注册 OkHttp 的 OkHttpClient
@Configuration
public class HttpConfig {
@Bean
public OkHttpClient okHttpClient() {
return new OkHttpClient.Builder()
.connectTimeout(10, TimeUnit.SECONDS)
.readTimeout(30, TimeUnit.SECONDS)
.build();
}
@Bean
public Retrofit retrofit(OkHttpClient client) { // 参数 client 由 Spring 自动注入
return new Retrofit.Builder()
.baseUrl("https://api.example.com/")
.client(client)
.addConverterFactory(GsonConverterFactory.create())
.build();
}
}
3. 控制 Bean 的作用域、名称与生命周期
@Bean 支持多种属性,常用如下:
-
name或value:指定 Bean 名称(默认为方法名) -
initMethod/destroyMethod:指定初始化/销毁方法(无需实现InitializingBean/DisposableBean) -
scope:设为ConfigurableBeanFactory.SCOPE_PROTOTYPE可改为原型作用域
示例:
@Bean(name = "myRedisTemplate", initMethod = "afterPropertiesSet")
@Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
public RedisTemplate<string object> redisTemplate(RedisConnectionFactory factory) {
RedisTemplate<string object> template = new RedisTemplate();
template.setConnectionFactory(factory);
template.setKeySerializer(new StringRedisSerializer());
return template;
}</string></string>
4. 注意事项
使用 @Bean 注册第三方类时需注意:
- 方法不能是
static(否则 Spring 无法代理增强,如 AOP、作用域代理会失效) - 避免在
@Bean方法中做耗时操作(如网络请求、大文件加载),应移至@PostConstruct或初始化方法中 - 若第三方类有多个构造参数且依赖其他 Bean,优先通过方法参数注入,而非在方法体内手动
ApplicationContext.getBean() - 同一配置类中多个
@Bean方法互相调用时,Spring 保证单例复用(即不会重复创建)
不复杂但容易忽略。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










