Spring多实例注入的三种实现方案与实战技巧

1. Spring多实例注入的本质与场景

在Spring框架的实际开发中，我们经常会遇到一个经典矛盾：默认的单例（Singleton）模式如何应对需要多个实例的场景？比如：

• 支付渠道需要同时对接微信、支付宝、银联等多个实现
• 消息队列需要根据业务类型创建不同配置的生产者
• 微服务调用时需要为不同下游服务创建独立的Feign客户端

这时候就需要打破Spring的默认单例约束，让容器能够按需创建多个实例。我在电商系统开发中就遇到过这样的案例：同一个商品服务需要同时对接自建仓储和第三方物流的接口，两者的API签名和超时配置完全不同。

2. 实现多实例的三种核心方案

2.1 @Scope注解动态控制

最直接的方式是通过@Scope注解显式声明作用域：

java复制@Bean 
@Scope("prototype")
public PaymentService wechatPayment() {
    return new WechatPaymentServiceImpl();
}

但这种方式有个隐藏陷阱：每次通过applicationContext.getBean()获取的确实是新实例，但在Controller中直接@Autowired注入时，由于Spring的代理机制，实际可能还是单例。解决方案是配合@Lookup注解使用：

java复制@RestController
public class OrderController {
    
    @Lookup
    public PaymentService getPaymentService() {
        return null; // 实际由Spring实现
    }
}

2.2 ObjectProvider延迟注入

Spring 4.3+提供了更优雅的ObjectProvider方案：

java复制@Service
public class OrderService {
    
    @Autowired
    private ObjectProvider<PaymentService> paymentServices;

    public void pay(String type) {
        PaymentService service = paymentServices.getIfAvailable(
            () -> new DefaultPaymentService()
        );
        // 每次调用getIfAvailable都会返回新实例
    }
}

实测发现，结合@Qualifier可以实现更精确的实例筛选：

java复制@Bean("alipay")
@Scope("prototype")
public PaymentService alipayService() { /*...*/ }

@Bean("wechat")
@Scope("prototype")
public PaymentService wechatService() { /*...*/ }

// 使用处
PaymentService service = paymentServices.getIfAvailable(
    () -> new DefaultPaymentService(),
    "alipay" // 指定qualifier
);

2.3 编程式Bean注册

在需要动态生成实例的场景（比如根据配置创建不同数据源），可以直接使用BeanDefinitionRegistry：

java复制public class DynamicBeanRegistrar implements BeanDefinitionRegistryPostProcessor {

    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) {
        GenericBeanDefinition definition = new GenericBeanDefinition();
        definition.setBeanClass(DynamicDataSource.class);
        definition.setScope(BeanDefinition.SCOPE_PROTOTYPE);
        definition.getPropertyValues().add("url", "jdbc:mysql://...");
        
        registry.registerBeanDefinition("dynamicDS", definition);
    }
}

我在多租户SAAS系统中就用这种方式，根据租户配置动态注册隔离的数据源实例。

3. 多实例场景下的依赖管理

3.1 循环依赖的破局方案

当多实例Bean之间存在循环依赖时，经典的Spring三级缓存机制会失效。这时需要引入中间代理：

java复制@Configuration
public class ProxyConfig {
    
    @Bean
    @Scope(proxyMode = ScopedProxyMode.TARGET_CLASS)
    public ServiceA serviceA() {
        return new ServiceAImpl();
    }
}

通过ScopedProxyMode.TARGET_CLASS创建CGLIB代理，使得注入的永远是代理对象，而实际实例每次重新生成。

3.2 生命周期管理的特殊处理

多实例Bean不会执行@PreDestroy回调，需要手动管理：

java复制public class ResourceHolder {
    private List<Closeable> resources = new ArrayList<>();

    public void register(Closeable resource) {
        resources.add(resource);
    }

    @PreDestroy
    public void cleanup() {
        resources.forEach(r -> {
            try { r.close(); } 
            catch (IOException e) { /* log */ }
        });
    }
}

4. 性能优化实战技巧

4.1 对象池化技术

频繁创建销毁实例会影响性能，可以结合Apache Commons Pool：

java复制@Bean
public GenericObjectPool<ExpensiveResource> resourcePool() {
    return new GenericObjectPool<>(new BasePooledObjectFactory<>() {
        @Override
        public ExpensiveResource create() {
            return new ExpensiveResource();
        }
    });
}

@Service 
public class PoolService {
    @Autowired 
    private GenericObjectPool<ExpensiveResource> pool;

    public void execute() throws Exception {
        ExpensiveResource resource = pool.borrowObject();
        try {
            resource.doSomething();
        } finally {
            pool.returnObject(resource);
        }
    }
}

4.2 原型模式的变体实现

对于线程安全的对象，可以复用实例但重置状态：

java复制public class ResetableService {
    private ThreadLocal<State> state = new ThreadLocal<>();

    public void execute() {
        State current = state.get();
        if(current == null) {
            current = new State();
            state.set(current);
        }
        // 使用current...
    }

    public void reset() {
        state.remove();
    }
}

5. 常见坑点排查指南

1. 代理失效问题：

   • 现象：标注了@Scope("prototype")但实际仍是单例
   • 检查点：是否在同类方法内调用（自调用代理不生效）
   • 解决方案：通过AopContext.currentProxy()获取代理对象

2. 内存泄漏场景：

   • 现象：GC时多实例Bean未被回收
   • 检查点：是否被长生命周期对象（如静态Map）持有引用
   • 解决方案：使用WeakReference包装引用

3. 事务失效：

   • 现象：@Transactional注解不生效
   • 检查点：是否在prototype Bean上使用事务注解
   • 解决方案：改为在调用方使用事务，或使用TransactionTemplate编程式事务

在金融项目开发中，我们曾遇到过一个典型案例：报表生成服务使用多实例模式，但由于没有正确清理ThreadLocal变量，导致用户数据交叉污染。最终通过实现DisposableBean接口强制清理线程变量解决了问题。