Spring Boot 2.3→3.2升级后XML中Map Bean无法加载的问题求助

核心原因 #

Spring Boot 3.x 基于 Spring Framework 6.x，两项关键变更导致原有逻辑失效：

1. 自动装配模式变更：Spring Framework 6.x 将 @Component 及其派生注解（如 @Repository）标注类的默认自动装配模式从 byName 改为 no。原来依赖 setter 方法名称（如 setQueries）自动匹配 Bean id（queries）的隐式装配规则不再生效。
2. Map 注入行为变更：使用 @Autowired 注入 Map 类型时，Spring 6.x 默认会收集容器中所有同泛型类型的 Bean（以 Bean 名称为 key、实例为 value 组成 Map），而非直接匹配单个 Map 类型的 Bean，因此出现找不到目标 Bean 的错误。

修复方案 #

方案一：使用 @Resource 按名称注入 #

@Resource 默认按 Bean 名称匹配，直接指定目标 Bean 的 id 即可完成注入：

@Repository
@ImportResource("classpath:applicationContext.xml")
public class EtlDataRepository {
    // ... 其他代码
    @Resource(name = "queries")
    private Map<String, String> queries;
    // ... setter/getter 可保留或移除（注解注入无需依赖setter）
}

若字段名与 Bean id 完全一致（均为 queries），可省略 name 属性：

@Resource
private Map<String, String> queries;

方案二：使用 @Autowired + @Qualifier 指定 Bean #

通过 @Qualifier 明确指定要注入的 Bean id，配合 @Autowired 实现精准匹配：

@Repository
@ImportResource("classpath:applicationContext.xml")
public class EtlDataRepository {
    // ... 其他代码
    @Autowired
    @Qualifier("queries")
    private Map<String, String> queries;
    // ... setter/getter 可保留或移除
}

额外确认事项 #

• 确保 @ImportResource 配置在 @SpringBootApplication 标注的启动类上（或当前 @Repository 类上），且 applicationContext.xml 文件确实位于项目的 classpath 目录下（如 src/main/resources）。
• 检查 XML 配置中 <util:map> 的 id="queries" 未被误修改，key-type 和 value-type 配置正确。

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