Spring Boot Bean实例化顺序影响因素及偶发多Bean冲突问题问询

问题场景 #

我们有一个运行正常的Spring Boot 2.2旧应用，近期发现dev环境无法启动，但本地启动完全正常。报错信息如下：

config.DomainConfig中companyServiceImpl方法的第0个参数需要单个Bean，但找到两个：restTemplate（定义于config/OAuth2ClientConfig.class的restTemplate方法）和oauth2RestTemplate（定义于config/OAuth2ClientConfig.class的oauth2RestTemplate方法）

相关代码 #

OAuth2ClientConfig中的Bean定义：

@Bean
protected RestTemplate restTemplate() {
    return new OAuth2RestTemplate(oAuthDetails());
}

@Bean
public OAuth2RestTemplate oauth2RestTemplate(OAuth2ProtectedResourceDetails details) {
    OAuth2RestTemplate oAuth2RestTemplate = new OAuth2RestTemplate(details);
    oAuth2RestTemplate.getAccessToken();
    return oAuth2RestTemplate;
}

DomainConfig中的Bean定义：

@Bean
public CompanyServiceImpl companyServiceImpl(OAuth2RestTemplate oAuth2RestTemplate) {
    return new CompanyServiceImpl(oAuth2RestTemplate);
}

补充背景：org.springframework.security.oauth2.client.OAuth2RestTemplate继承自org.springframework.web.client.RestTemplate，二者属于同一类型体系；本地和dev环境均使用JDK 11，配置中无环境Profile或@Conditional注解。

本地调试时，Spring先实例化oauth2RestTemplate并注入给companyServiceImpl，之后才创建restTemplate——此时注入companyServiceImpl时容器内仅存在一个OAuth2RestTemplate实例，因此启动正常。但dev环境中两个RestTemplate类型的Bean会先于companyServiceImpl创建，导致注入时出现多Bean匹配冲突。

我们已通过移除restTemplate()方法修复问题，但有以下疑问：

1. 为什么这个明显的问题长期未触发报错？
2. 哪些本地环境参数会影响Bean的实例化顺序？
3. 这种本地正常、dev报错的情况只是偶然吗？

解答 #

1. 长期未触发报错的原因 #

Spring的Bean实例化顺序无固定规则，会根据Bean依赖关系、容器初始化逻辑动态调整。在此前的运行环境（包括本地）中，恰好每次都是oauth2RestTemplate先被实例化并满足companyServiceImpl的依赖，之后才创建restTemplate——此时companyServiceImpl已完成注入，不会再检测新Bean是否与已注入类型冲突。只有当companyServiceImpl的依赖注入发生在两个RestTemplate类型Bean都实例化之后，才会触发多Bean匹配错误。

2. 影响Bean实例化顺序的本地参数 #

以下因素可能导致本地与dev环境的Bean顺序差异：

• 类加载顺序：本地用IDE加载类，dev用打包后的JAR/WAR，类路径结构不同会影响Spring扫描Bean定义的顺序。
• 文件系统排序规则：Spring扫描包时会按包名、类名字典序扫描，本地与dev的文件系统大小写敏感规则不同，可能改变扫描顺序。
• IDE编译/缓存逻辑：本地IDE的编译顺序、缓存机制可能导致Bean定义加载顺序与生产环境不一致。
• JVM参数差异：不同的JVM参数（如GC线程数、类加载相关参数）可能间接影响容器初始化的并发逻辑，改变Bean实例化顺序。
• 依赖细微版本差异：即使JDK版本一致，本地与dev的Spring或第三方依赖若存在小版本差异，也可能影响容器内部初始化逻辑。

3. 是否属于偶然情况？ #

这不是纯粹的偶然，而是潜在的不稳定状态被触发。代码本身存在设计缺陷：同时定义了两个同类型（RestTemplate）的Bean，而companyServiceImpl依赖的OAuth2RestTemplate是RestTemplate的子类，Spring注入时会将所有RestTemplate类型Bean视为候选。只要实例化顺序满足“companyServiceImpl依赖注入前，容器中存在多个RestTemplate类型Bean”，就必然触发错误。之前未报错只是恰好每次顺序都避开了冲突场景。

规范建议 #

除了移除冗余Bean，更规范的做法包括：

• 避免定义同类型（含继承关系）的冗余Bean。
• 若必须存在多个同类型Bean，使用@Qualifier指定注入的Bean名称，消除歧义。
• 永远不要依赖Spring的Bean实例化顺序，它无官方保证，会随环境、版本变化而改变。

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