调用XML配置的外部Jar类导致Spring Boot启动失败求助

问题详情 #

尝试在Spring Boot应用中调用一个基于XML配置的外部Spring框架Jar包，启动时出现依赖注入失败，相关代码及报错如下：

外部Jar包内容 #

核心Java类

package com.ext.beans;

public class ExtBean{
    extMethod() {
     // some action
    };
}

Spring XML配置（application-context.xml）

<bean id="extBean" class="com.ext.beans.ExtBean" scope="prototype"/>

自身Spring Boot代码 #

配置类

@Configuration
@ComponentScan({"com.ext.beans"})
public class ParentConfig {

    @Bean("extBean")
    public ExtBean extBean() {
        return new ExtBean();
    }
}

服务类

@Service
public class ParentService {
    @Autowired
    @Qualifier("extBean")
    ExtBean extBean;
    
    public ParentServiceMethod() {
        //perform function with extBean method
        extBean.extMethod();
   }
}

报错信息 #

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'parentService': Unsatisfied dependency expressed through field 'extBean'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'extBean' defined in class path resource [com/parent/config/ParentConfig.class]

注：已在Spring Boot的pom.xml中添加该外部Jar的依赖。

问题根源 #

1. Bean定义冲突：外部Jar的XML配置与你的ParentConfig中手动定义了同名的extBean，导致Spring容器出现重复Bean定义，触发依赖注入异常。
2. 无效的ComponentScan：ExtBean未标注@Component等Spring注解，@ComponentScan({"com.ext.beans"})无法扫描到该类，属于冗余配置。
3. 作用域不匹配：外部Jar中extBean是prototype作用域，但你的手动Bean定义未指定该作用域，同时直接实例化可能忽略Jar中该Bean的其他潜在配置。
4. 方法访问权限问题：ExtBean的extMethod()为包级私有，若ParentService不在同包下，后续调用会出现权限问题（虽不是本次报错直接原因，但属于潜在问题）。

解决办法 #

方法一：导入外部Jar的XML配置（推荐） #

直接让Spring Boot加载外部Jar中的XML配置，无需手动定义Bean，保留原Bean的配置和作用域：

@Configuration
@ImportResource(locations = {"classpath:application-context.xml"})
public class ParentConfig {
    // 移除手动定义的extBean方法
}

确认外部Jar中的application-context.xml位于类路径根目录，若路径不同需调整locations参数。

方法二：修正手动Bean定义 #

如果不想导入XML，需确保仅保留一处Bean定义，并匹配原配置的作用域：

1. 删除ParentConfig中的@ComponentScan({"com.ext.beans"})（无效配置）
2. 修正Bean定义，指定prototype作用域：

@Configuration
public class ParentConfig {

    @Bean("extBean")
    @Scope("prototype")
    public ExtBean extBean() {
        return new ExtBean();
    }
}

额外修复：方法访问权限 #

将ExtBean的extMethod()改为public，确保跨包可调用：

package com.ext.beans;

public class ExtBean{
    public void extMethod() {
     // some action
    }
}

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