Spring多@Primary注解Bean冲突引发依赖注入失败问题

问题场景 #

生产环境定义了两个String类型Bean：

@Bean("imageKitPath")
public String imageKitPath() {
    return "/main";
}

@Bean("jwtKey")
public String jwtKey() {
    // 从文件读取密钥的逻辑
    return jwtKey;
}

测试环境为了覆盖这两个Bean，定义了新的Bean并标记@Primary：

@Bean
@Primary
public String imageKitPath2() {
    return "/test";
}

@Bean
@Primary
public String jwtKey2() {
    // 从application.properties读取密钥的逻辑
    return jwtKey;
}

注入到JwtService时遇到三类问题：

• 无限定构造注入：生产环境正常，测试环境抛出org.springframework.beans.factory.NoUniqueBeanDefinitionException，提示存在多个primary类型为String的Bean
• 用@Qualifier("jwtKey")构造注入：生产环境正常，测试环境仍获取生产环境的JWT密钥
• 用@Qualifier("jwtKey2")构造注入：测试环境正常，生产环境因找不到jwtKey2Bean启动失败

排查后确认：两个@Primary标记的String类型Bean导致Spring无法区分，引发注入冲突。

解决方案 #

方案1：通过@Profile实现环境隔离+同名Bean覆盖

给生产和测试环境的Bean分别标记对应环境的@Profile，并使用相同的Bean名称，Spring会自动根据当前激活的环境加载对应的Bean，无需额外标记@Primary。

生产环境Bean定义：

@Bean("imageKitPath")
@Profile("prod")
public String imageKitPath() {
    return "/main";
}

@Bean("jwtKey")
@Profile("prod")
public String jwtKey() {
    // 从文件读取密钥的逻辑
    return jwtKey;
}

测试环境Bean定义：

@Bean("imageKitPath")
@Profile("test")
public String imageKitPath() {
    return "/test";
}

@Bean("jwtKey")
@Profile("test")
public String jwtKey() {
    // 从application.properties读取密钥的逻辑
    return jwtKey;
}

注入时直接使用@Qualifier指定Bean名称，或按类型注入（每个环境仅存在一个对应名称的Bean）：

@Service
public class JwtService {
    private final String jwtKey;
    private final String imageKitPath;

    public JwtService(@Qualifier("jwtKey") String jwtKey, @Qualifier("imageKitPath") String imageKitPath) {
        this.jwtKey = jwtKey;
        this.imageKitPath = imageKitPath;
    }
}

方案2：用配置文件+@Value替代String Bean（推荐）

将环境相关的配置值放到对应环境的配置文件中，直接通过@Value注入，彻底避免String类型Bean的冲突问题。

生产环境配置文件application-prod.properties：

image.kit.path=/main
jwt.key=your-prod-jwt-key

测试环境配置文件application-test.properties：

image.kit.path=/test
jwt.key=your-test-jwt-key

注入时直接使用@Value读取配置：

@Service
public class JwtService {
    private final String jwtKey;
    private final String imageKitPath;

    public JwtService(@Value("${jwt.key}") String jwtKey, @Value("${image.kit.path}") String imageKitPath) {
        this.jwtKey = jwtKey;
        this.imageKitPath = imageKitPath;
    }
}

方案3：用@ConditionalOnMissingBean确保Bean唯一性

如果必须保留Bean定义的方式，可以给测试环境的Bean添加@ConditionalOnMissingBean，确保仅当生产环境的Bean不存在时才创建测试Bean，同时保持Bean名称一致：

测试环境Bean定义：

@Bean("imageKitPath")
@ConditionalOnMissingBean(name = "imageKitPath")
public String imageKitPath() {
    return "/test";
}

@Bean("jwtKey")
@ConditionalOnMissingBean(name = "jwtKey")
public String jwtKey() {
    // 从application.properties读取密钥的逻辑
    return jwtKey;
}

注入方式同方案1，使用@Qualifier指定Bean名称即可。

问题根源解释 #

1. 多个@Primary标记的同类型Bean：Spring在按类型注入时，若存在多个标记为@Primary的同类型Bean，会直接抛出冲突异常
2. 未隔离环境Bean：测试环境启动时，生产环境的Bean并未被排除，导致容器中同时存在同名（或不同名）的同类型Bean，使用@Qualifier指定生产Bean名称时，会直接获取生产环境的实例
3. 不同名的测试Bean：生产环境不存在测试Bean的名称，导致注入失败

内容的提问来源于stack exchange，提问作者IceMajor