Spring如何根据激活profile加载对应接口实现bean，解决多bean冲突问题

根因分析 #

你遇到的报错核心原因是：激活test profile时，标注了@Profile("production")的父类MailServiceImpl依然被注册到了Spring容器中，导致同接口存在两个实现类，触发注入冲突。
按照你给出的代码逻辑，理论上激活test profile时MailServiceImpl不会被注册，大概率是踩到了以下常见的坑：

• profile名称拼写不匹配：@Profile("production")的名称和生产环境实际激活的profile名称不一致（比如生产实际用的是prod），导致该注解未生效，所有环境都会注册父类bean
• 多profile同时激活：配置了spring.profiles.include=production、启动参数加了多profile、测试类@ActiveProfiles同时指定了多个profile，导致production也被隐式激活
• 重复注册bean：在@Configuration配置类中通过@Bean手动注册了MailServiceImpl，没有加profile限制

解决方案 #

方案1：重构类结构（最推荐） #

将公共逻辑抽为抽象父类，避免两个带@Service的实现类存在继承关系，从根源避免重复注册问题：

// 抽象父类，存放公共逻辑，不加@Service和@Profile注解
public abstract class AbstractMailService implements MailService {
    // 公共方法实现
}

// 生产环境实现类
@Service
@Profile("production")
public class MailServiceImpl extends AbstractMailService {
}

// 测试环境实现类
@Service
@Profile("test")
public class SinkMailServiceImpl extends AbstractMailService {
}

方案2：修改父类Profile限制（无需重构） #

如果不想调整现有类结构，直接修改MailServiceImpl的@Profile注解，明确test环境不注册：

@Service
@Profile({"production", "!test"})
public class MailServiceImpl implements MailService {

!test表示只要test profile处于激活状态，当前类就不会被注册为bean，不会和子类冲突。

方案3：增加缺失bean条件注解 #

保留现有继承结构的前提下，在子类上增加@ConditionalOnMissingBean注解，避免同类型bean重复注册：

@Service
@Profile("test")
@ConditionalOnMissingBean(MailService.class)
public class SinkMailServiceImpl extends MailServiceImpl {

验证方法 #

修改后启动应用时添加--debug启动参数，查看Spring的bean注册日志，确认对应环境下只有一个MailService实现类被注册即可。

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