Spring转SpringBoot后终端运行报BeanDefinitionOverrideException求助

根本原因 #

1. 重复Bean定义冲突：DataServer类被@SpringBootApplication标记，该注解包含@Component，SpringBoot会自动将其注册为名为dataServer（类名首字母小写的默认Bean名称）的单例Bean；同时你通过@ImportResource导入了data-server-context.xml，里面又显式定义了id为dataServer的Bean，同一个Spring上下文内出现两个同名Bean定义，触发BeanDefinitionOverrideException。
2. 多余的上下文创建：main方法中手动实例化ClassPathXmlApplicationContext，会创建第二个独立的Spring上下文，完全没必要，还会加重资源加载冲突的风险。
3. 配置未生效的可能：终端运行时spring.main.allow-bean-definition-overriding=true未生效，大概率是因为jar包运行时application.properties路径不正确，或者配置未被SpringBoot正确读取，但更关键的是，这个配置只是“允许覆盖”，而非解决重复定义的根源。

修复步骤 #

1. 移除XML中重复的dataServer Bean定义 #

删掉data-server-context.xml里的这段配置：

<bean id="dataServer" class="com.company.data.DataServer">
    <constructor-arg name="arg1" ref="arg1_ref"/>
    <constructor-arg name="arg2" ref="arg2_ref"/>
</bean>

SpringBoot已经通过组件扫描自动注册了DataServer Bean，不需要重复定义。

2. 重构main方法，复用SpringBoot创建的上下文 #

删掉手动创建ClassPathXmlApplicationContext的代码，直接使用SpringApplication.run()返回的上下文：

public static void main(String[] args) throws Exception {
    // 复用SpringBoot启动的上下文
    ApplicationContext ctx = SpringApplication.run(DataServer.class, args);

    LOG.info("Starting Data Server...");
    try {
        dataServer = ctx.getBean(DataServer.class);
        dataServer.func1();
    } catch (Exception e) {
        // 日志记录
        throw e;
    }
    LOG.info("Data server started successfully!");
}

3. 处理DataServer的构造参数注入 #

原来XML中给dataServer配置的构造参数，改用SpringBoot的注解方式注入：

• 如果参数是Spring容器中的其他Bean：

@Autowired
public DataServer(Arg1BeanType arg1, Arg2BeanType arg2) {
    // 赋值逻辑
}

• 如果参数是配置文件中的值：

public DataServer(@Value("${your.config.arg1}") String arg1, @Value("${your.config.arg2}") String arg2) {
    // 赋值逻辑
}

4. （可选）确保配置文件正确加载 #

如果确实需要保留Bean覆盖配置（不推荐），运行jar时显式指定配置文件路径：

java -cp your-app-jar-with-dependencies.jar -Dspring.config.location=classpath:/application.properties com.company.data.DataServer

补充说明 #

IntelliJ中运行正常是因为IDE的运行环境会自动处理一些类路径和配置加载细节，而终端纯jar包环境更贴近生产环境，会暴露这类配置冲突问题。从根源上消除重复Bean定义，才是最稳妥的解决方案。

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