动态加载 Spring Beans 的正确姿势-java教程-PHP中文网

动态加载 Spring Beans 的正确姿势

心靈之曲

发布： 2025-08-16 20:26:24

原创

406人浏览过

动态加载 spring beans 的正确姿势

本文旨在解决在 Spring 应用中，根据运行环境动态加载不同 Bean 实现的问题。通过使用 @Conditional 注解和手动创建 Bean 的方式，可以优雅地实现基于环境的 Bean 动态加载，避免了 Spring 无法区分多个实现了同一接口的 Bean 的问题，并提供了清晰的配置和易于测试的方案。

在 Spring 应用开发中，经常会遇到需要根据不同的环境（例如：开发、测试、生产）加载不同的 Bean 实现的场景。例如，在生产环境中执行实际的业务逻辑，而在测试环境中则使用 Mock 对象或者 No-op 实现。本文将介绍一种使用 @Conditional 注解和手动创建 Bean 的方法，来实现动态加载 Spring Beans，解决 Spring 无法区分多个实现了同一接口的 Bean 的问题。

问题描述

假设我们有一个接口 DoThingInterface，以及两个实现了该接口的类：DoThingService 和 NoopService。DoThingService 负责执行实际的业务逻辑，而 NoopService 则是一个空操作的实现。我们希望根据当前环境来决定加载哪个 Bean。

一种常见的错误做法是直接在 DoThingService 和 NoopService 类上使用 @Conditional 注解，如下所示：

public interface DoThingInterface {
    void doThing();
}

@Conditional(DoThingCondition.class)
@Component
public class DoThingService implements DoThingInterface {
    @Override
    public void doThing() {
       // business logic
    }
}

@Conditional(DoNotDoThingCondition.class)
@Component
public class NoopService implements DoThingInterface {
    @Override
    public void doThing() {
        // noop
    }
}

@Component
public class AppController {

    @Autowired
    private DoThingInterface doThingService;

    public void businessLogicMethod() {
        doThingService.doThing();
    }
}

登录后复制

在这种情况下，即使 DoThingCondition 和 DoNotDoThingCondition 是互斥的，Spring 仍然会尝试同时创建 DoThingService 和 NoopService 的 Bean，并抛出 NoUniqueBeanDefinitionException 异常，因为 Spring 无法确定应该注入哪个 Bean 到 AppController 中。

解决方案：使用配置类和手动创建 Bean

正确的做法是将 @Conditional 注解移动到配置类中，并手动创建 Bean。具体步骤如下：

定义 Condition 类：

首先，定义两个 Condition 类，用于判断是否应该创建对应的 Bean。

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class DoNotDoTheThingCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        // 替换为你的实际逻辑
        String region = "someRegion";
        String profile = "prod";
        return !(region.equals(region) && profile.contains("prod"));
    }
}

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class DoThingCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        // 替换为你的实际逻辑
        String region = "someRegion";
        String profile = "prod";
        return (region.equals(region) && profile.contains("prod"));
    }
}

登录后复制

注意: 上述代码中 region 和 profile 变量需要替换为实际的获取逻辑，例如从环境变量、配置文件或 Spring 的 Environment 中获取。

创建配置类：

创建一个配置类，并使用 @Conditional 注解来控制 Bean 的创建。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;

@Configuration
public class DoThingConfiguration {
    @Conditional(DoThingCondition.class)
    @Bean
    public DoThingInterface doThingService() {
        return new DoThingService();
    }

    @Conditional(DoNotDoTheThingCondition.class)
    @Bean
    public DoThingInterface noopService() {
        return new NoopService();
    }
}

登录后复制

定义接口和实现类：

定义接口 DoThingInterface 和两个实现类 DoThingService 和 NoopService。

度加剪辑

度加剪辑（原度咔剪辑），百度旗下AI创作工具

查看详情

public interface DoThingInterface {
    void doThing();
}

import org.springframework.stereotype.Service;

@Service // 可选，如果需要在其他地方注入该Bean
public class DoThingService implements DoThingInterface {
    @Override
    public void doThing() {
        // business logic
        System.out.println("Doing the thing!");
    }
}

import org.springframework.stereotype.Service;

@Service // 可选，如果需要在其他地方注入该Bean
public class NoopService implements DoThingInterface {
    @Override
    public void doThing() {
        // Noop
        System.out.println("Noop!");
    }
}

登录后复制

Controller 的修改:

Controller 的修改保持不变，Spring 会根据配置自动注入正确的 Bean。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class AppController {
    @Autowired
    private DoThingInterface doThingService;

    public void businessLogicMethod() {
        doThingService.doThing();
    }
}

登录后复制

完整示例代码

以下是完整的示例代码：

Condition 类:

// DoNotDoTheThingCondition.java
import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class DoNotDoTheThingCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        String region = "someRegion";
        String profile = "prod";
        return !(region.equals(region) && profile.contains("prod"));
    }
}

// DoThingCondition.java
import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class DoThingCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        String region = "someRegion";
        String profile = "prod";
        return (region.equals(region) && profile.contains("prod"));
    }
}

登录后复制

配置类:

// DoThingConfiguration.java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;

@Configuration
public class DoThingConfiguration {
    @Conditional(DoThingCondition.class)
    @Bean
    public DoThingInterface doThingService() {
        return new DoThingService();
    }

    @Conditional(DoNotDoTheThingCondition.class)
    @Bean
    public DoThingInterface noopService() {
        return new NoopService();
    }
}

登录后复制

服务类:

// DoThingInterface.java
public interface DoThingInterface {
    void doThing();
}

// DoThingService.java
import org.springframework.stereotype.Service;

@Service
public class DoThingService implements DoThingInterface {
    @Override
    public void doThing() {
        System.out.println("Doing the thing!");
    }
}

// NoopService.java
import org.springframework.stereotype.Service;

@Service
public class NoopService implements DoThingInterface {
    @Override
    public void doThing() {
        System.out.println("Noop!");
    }
}

登录后复制

Controller 类:

// AppController.java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class AppController {
    @Autowired
    private DoThingInterface doThingService;

    public void businessLogicMethod() {
        doThingService.doThing();
    }
}

登录后复制