1. 项目背景与核心价值
在Spring框架的实际开发中，我们经常需要管理各种bean的实例化过程。虽然大多数情况下我们会使用@Component、@Service等注解来自定义bean，但掌握非自定义bean的配置方式同样重要。这种技术手段在以下场景中尤为关键：
- 集成第三方库时（这些类通常无法添加Spring注解）
- 需要精细控制实例化过程（如构造器参数、初始化方法等）
- 动态决定bean实现类的场景
- 遗留系统改造中的渐进式迁移
我最近在重构一个老项目时，就遇到了需要将传统JDBC代码迁移到Spring管理的案例。通过XML和Java Config两种方式配置DataSource，让我对bean实例化有了更深刻的理解。下面分享几种实用的配置方式及其背后的原理。
2. 基础配置方式对比
2.1 XML配置方式详解
虽然现在Java Config更流行，但XML配置仍然是理解bean实例化的基础。典型的配置如下：
xml复制<bean id="dataSource" class="com.zaxxer.hikari.HikariDataSource">
<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/test"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
<property name="maximumPoolSize" value="20"/>
</bean>
关键点解析：
class属性必须使用全限定类名- 基本类型属性直接用value注入
- 引用类型属性使用ref指向其他bean
- 集合类型可以用
<list>、<map>等标签配置
经验之谈：在配置连接池时，建议将敏感信息抽取到properties文件，通过${}占位符引用，避免密码硬编码。
2.2 Java Config配置方式
现代Spring项目更推荐使用Java Config方式：
java复制@Configuration
public class DataSourceConfig {
@Bean
public DataSource dataSource() {
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/test");
config.setUsername("root");
config.setPassword("123456");
config.setMaximumPoolSize(20);
return new HikariDataSource(config);
}
}
相比XML的优势：
- 编译时类型检查
- IDE更好的代码提示
- 更容易实现条件化配置
- 配置逻辑可以更灵活（比如添加判断逻辑）
2.3 注解配置的混合使用
实际项目中常常混合使用各种方式：
java复制@Configuration
@ImportResource("classpath:legacy-beans.xml")
public class AppConfig {
@Bean
@Autowired
public ServiceA serviceA(DataSource dataSource) {
return new ServiceA(dataSource);
}
}
这种混合方式特别适合：
- 逐步迁移的老系统
- 需要同时集成新旧组件
- 部分配置需要动态生成的场景
3. 高级实例化技巧
3.1 构造器注入的多种写法
当bean需要通过构造器注入时，不同配置方式的对比：
XML方式：
xml复制<bean id="userService" class="com.example.UserService">
<constructor-arg ref="userRepository"/>
<constructor-arg value="100"/>
</bean>
Java Config方式：
java复制@Bean
public UserService userService(UserRepository userRepository) {
return new UserService(userRepository, 100);
}
注解方式：
java复制@Service
public class UserService {
private final UserRepository repository;
private final int maxRetry;
@Autowired
public UserService(UserRepository repository, @Value("${user.maxRetry}") int maxRetry) {
this.repository = repository;
this.maxRetry = maxRetry;
}
}
特别注意：当有多个构造器时，Spring默认选择参数最多的构造器。可以使用@Autowired指定要使用的构造器。
3.2 FactoryBean的特殊用法
对于复杂对象的创建，可以实现FactoryBean接口：
java复制public class MyComplexBeanFactory implements FactoryBean<MyComplexBean> {
@Override
public MyComplexBean getObject() throws Exception {
// 复杂的构建逻辑
MyComplexBean bean = new MyComplexBean();
bean.init();
return bean;
}
@Override
public Class<?> getObjectType() {
return MyComplexBean.class;
}
}
配置方式：
java复制@Bean
public MyComplexBeanFactory myComplexBean() {
return new MyComplexBeanFactory();
}
使用时Spring会自动调用getObject()方法，实际获取的是MyComplexBean实例而非工厂本身。
3.3 实例化回调方法
可以在bean生命周期的特定节点执行自定义逻辑：
java复制public class InitDemoBean {
private void init() {
System.out.println("自定义初始化方法");
}
private void destroy() {
System.out.println("自定义销毁方法");
}
}
XML配置方式：
xml复制<bean id="initDemo" class="com.example.InitDemoBean"
init-method="init" destroy-method="destroy"/>
Java Config方式：
java复制@Bean(initMethod = "init", destroyMethod = "destroy")
public InitDemoBean initDemo() {
return new InitDemoBean();
}
4. 条件化配置实战
4.1 Profile的不同环境配置
使用@Profile注解实现环境隔离：
java复制@Configuration
public class EnvConfig {
@Bean
@Profile("dev")
public DataSource devDataSource() {
// 开发环境配置
}
@Bean
@Profile("prod")
public DataSource prodDataSource() {
// 生产环境配置
}
}
激活方式：
- 启动参数：-Dspring.profiles.active=dev
- 环境变量：export SPRING_PROFILES_ACTIVE=prod
- 测试注解：@ActiveProfiles("test")
4.2 Conditional条件装配
更灵活的条件判断：
java复制@Bean
@ConditionalOnClass(name = "com.example.SpecialClass")
public SpecialBean specialBean() {
return new SpecialBean();
}
@Bean
@ConditionalOnProperty(name = "cache.enabled", havingValue = "true")
public CacheManager cacheManager() {
return new EhCacheManager();
}
常用条件注解：
- @ConditionalOnClass：类路径存在指定类时生效
- @ConditionalOnMissingBean：容器中不存在指定bean时生效
- @ConditionalOnProperty：配置属性满足条件时生效
- @ConditionalOnWebApplication：Web环境时生效
5. 常见问题排查指南
5.1 Bean创建失败常见原因
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| NoSuchBeanDefinitionException | 1. 未扫描到包 2. 条件不满足 3. 名称拼写错误 |
1. 检查@ComponentScan 2. 检查@Conditional条件 3. 确认bean名称 |
| BeanInstantiationException | 1. 构造器抛出异常 2. 抽象类无法实例化 |
1. 检查构造器逻辑 2. 确保不是抽象类 |
| UnsatisfiedDependencyException | 1. 依赖bean不存在 2. 循环依赖 |
1. 检查依赖bean配置 2. 使用setter注入解决循环依赖 |
5.2 生命周期相关问题的调试技巧
当bean的初始化/销毁方法未按预期执行时：
- 确认方法签名正确（无参数，void返回类型）
- 检查是否有多个同名方法造成混淆
- 对于@PreDestroy，确保正常关闭容器
- 使用BeanPostProcessor接口添加日志调试
java复制public class LifecycleDebugProcessor implements BeanPostProcessor {
@Override
public Object postProcessBeforeInitialization(Object bean, String beanName) {
System.out.println("Before init: " + beanName);
return bean;
}
@Override
public Object postProcessAfterInitialization(Object bean, String beanName) {
System.out.println("After init: " + beanName);
return bean;
}
}
5.3 配置覆盖问题的处理
当出现配置不生效的情况：
- 检查是否有多个同类型@Configuration类
- 确认@Order注解的使用是否正确
- 检查是否意外使用了@Primary
- 查看bean定义的覆盖日志：
properties复制# application.properties
logging.level.org.springframework.beans.factory.support=DEBUG
6. 性能优化实践
6.1 延迟初始化配置
对于不立即需要的bean，可以延迟初始化：
java复制@Bean
@Lazy
public ExpensiveBean expensiveBean() {
return new ExpensiveBean(); // 只有第一次使用时才会初始化
}
适用场景：
- 启动时不立即需要的组件
- 资源消耗大的bean
- 可能根本不会用到的可选功能
6.2 原型bean的正确使用
默认单例模式下，prototype作用域的注意事项：
java复制@Bean
@Scope("prototype")
public PrototypeBean prototypeBean() {
return new PrototypeBean();
}
@Service
public class SingletonService {
@Autowired
private Provider<PrototypeBean> prototypeBeanProvider;
public void usePrototype() {
PrototypeBean bean = prototypeBeanProvider.get();
// 每次获取新实例
}
}
关键点：不要直接@Autowire原型bean，而应该使用Provider或方法注入。
6.3 配置类优化技巧
大型项目中配置类的组织建议：
- 按功能模块拆分多个@Configuration类
- 使用@Import组合相关配置
- 条件化加载配置减少不必要的bean定义
- 对稳定不变的bean使用@Configuration(proxyBeanMethods=false)
java复制@Configuration(proxyBeanMethods = false) // 轻量级模式
public class StaticConfig {
@Bean
public static BeanA beanA() {
return new BeanA();
}
}
这种模式下Spring不会创建CGLIB代理，减少运行时开销。