SpringBoot生产环境启动失败：找不到CustomizedSnowFlake类型Bean

核心问题 #

开发/测试环境中，自定义的CustomizedSnowFlake Bean能正常覆盖全局的Snowflake Bean，生产环境却因容器中只有父类Snowflake Bean，无法注入子类CustomizedSnowFlake而启动失败，报错required a bean of type xxxxxxx that could not be found。

原因拆解 #

1. Bean注册顺序与覆盖规则差异 #

• 开发/测试环境（如IDE本地运行）：组件扫描时，业务模块（module-application）的CustomizedSnowFlakeConfig会先被加载，注册返回CustomizedSnowFlake实例的Bean（即使方法返回类型是Snowflake）。此时全局模块（module-common）的GlobalSnowFlakeConfig触发@ConditionalOnMissingBean(Snowflake.class)检查，发现已有Snowflake类型Bean，因此不会注册全局Bean。容器中实际存在的是CustomizedSnowFlake实例，满足注入要求。
• 生产环境（Jar包运行）：类加载顺序与本地相反，全局模块的GlobalSnowFlakeConfig先被加载，此时容器中无Snowflake类型Bean，所以注册了全局的Snowflake Bean。后续扫描到业务模块的同名Bean时，因SpringBoot默认禁用Bean覆盖（spring.main.allow-bean-definition-overriding=false），该Bean定义被直接忽略。容器中仅存在父类Snowflake实例，无法匹配子类CustomizedSnowFlake的注入需求，导致报错。

2. @Bean方法返回类型的影响 #

当CustomizedSnowFlakeConfig的initializeSnowFlake方法返回类型为Snowflake时，Spring解析Bean定义时标记的Bean类型是父类Snowflake，与全局Bean的类型完全一致，同名情况下极易因加载顺序导致覆盖失败。而将返回类型改为CustomizedSnowFlake后：

• Bean定义的类型被标记为子类CustomizedSnowFlake，全局模块的@ConditionalOnMissingBean(Snowflake.class)会识别到已有Snowflake类型的Bean（子类实例属于父类类型），因此不会注册全局Bean；
• 同时，容器中注册的Bean类型就是CustomizedSnowFlake，直接满足注入要求。

解决方案 #

方案1：明确设置Bean覆盖允许（不推荐） #

在生产环境配置文件中添加：

spring.main.allow-bean-definition-overriding=true

此配置允许同名Bean覆盖，确保业务模块的Bean能覆盖全局Bean，但可能引发其他Bean覆盖的潜在风险。

方案2：修改@Bean方法返回类型（推荐） #

将CustomizedSnowFlakeConfig中的initializeSnowFlake方法返回类型改为CustomizedSnowFlake：

@Bean
public CustomizedSnowFlake initializeSnowFlake() {
    return new CustomizedSnowFlake();
}

这种方式从Bean定义层面明确类型，既避免了加载顺序带来的问题，又能让@ConditionalOnMissingBean正确识别已有Bean，确保全局Bean不会被注册。

方案3：给自定义Bean添加@Primary注解 #

在CustomizedSnowFlakeConfig的@Bean方法上添加@Primary注解，确保当存在多个Snowflake类型Bean时，优先选择自定义的Bean：

@Bean
@Primary
public Snowflake initializeSnowFlake() {
    return new CustomizedSnowFlake();
}

此方式无需修改返回类型，通过优先级设置确保自定义Bean被选中，同时兼容@ConditionalOnMissingBean的逻辑。

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