多模块Spring项目中排除Maven依赖中的PersonController类并解决Bean冲突问题

看起来你遇到了Spring多模块项目里典型的Bean命名冲突坑——外部依赖里带@RestController的PersonController，和你自己实现的版本撞名了，而且之前尝试的排除规则都没生效，对吧？我来帮你一步步捋清楚问题根源，再给出可行的解决方案。

先搞懂为什么之前的排除没起作用 #

你提到@SpringBootApplication的扫描先执行，这确实是核心原因！@SpringBootApplication本身就包含了@ComponentScan功能，它的扫描优先级比你自定义@Configuration类里的@ComponentScan高得多，所以你在PersonConfiguration里设置的排除规则根本没机会生效——外部的PersonController已经被扫描并注册成Bean了，之后你通过@Bean定义的版本自然就会报冲突。

另外你用@SpringBootApplication(exclude = { PersonController.class })也没用，因为这个exclude参数是用来排除自动配置类的，不是用来排除普通组件类的，完全用错地方啦！

解决方案一：直接在SpringBoot启动类上配置精准扫描规则 #

既然@SpringBootApplication的扫描是最先执行的，那我们直接在它上面配置正确的排除规则就好（它本质上支持@ComponentScan的所有参数）：

@SpringBootApplication(
    scanBasePackages = {"xl.app", "xl.person"}, // 包含你需要用到的依赖包路径
    excludeFilters = {
        @ComponentScan.Filter(
            type = FilterType.ASSIGNABLE_TYPE,
            value = xl.person.controller.PersonController.class
        )
    }
)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

这样Spring启动扫描时会直接跳过外部依赖里的PersonController，不会把它注册成Bean，之后你在PersonConfiguration里通过@Bean定义的版本就能正常注册，再加上@Primary注解，就算有其他地方不小心引入了同名Bean，你的版本也会被优先使用。

解决方案二：给自定义Controller指定唯一Bean名称 #

如果你不想修改扫描规则，或者担心扫描规则影响其他组件，那可以直接给你自己的PersonController指定一个独特的Bean名称，避开冲突：
要么在类上直接指定：

@RestController("customPersonController") // 自定义Bean名称
public class PersonController {
    // 你的业务逻辑代码
}

要么在@Bean定义时指定：

@Bean("customPersonController")
@Primary
PersonController personController(PersonService service, PersonSecondService serviceTwo) {
    return new PersonController(service, serviceTwo);
}

这样两个Bean的名称不一样，就不会触发冲突了。不过这种方式的缺点是，外部依赖里的PersonController还是会被注册成Bean，可能占用不必要的资源，所以更推荐第一种方案。

额外思路：从依赖层面减少冲突可能 #

如果外部模块里你只需要用到PersonService这类服务层组件，根本不需要它的Controller，那可以检查一下Maven依赖的引入范围——能不能只引入服务层的子模块？而不是把整个包含Controller的模块都拉进来？这算是从根源避免冲突的思路，不过得看你的项目结构是否支持。

备注：内容来源于stack exchange，提问作者furion2000