Spring中Bean名称重叠时，配置方法返回类型影响覆盖日志输出的原因咨询

已知通过@Component组件扫描注册的Bean与@Bean配置方法注册的Bean同名时会发生覆盖，但当@Bean方法的返回类型指定为实现类而非接口时，Spring未输出预期的覆盖日志。以下是复现与分析：

代码定义 #

• 接口BeanInterface：

package hello.core.bean_overriding;

public interface BeanInterface {
}

• 实现类BeanA（通过@Component自动注册，Bean名称为beanA）：

package hello.core.bean_overriding;

import org.springframework.stereotype.Component;

@Component
public class BeanA implements BeanInterface {
    public BeanA() {
        System.out.println("BeanA.BeanA = " + this);
    }
}

两种复现场景 #

场景1：@Bean返回接口类型

@Configuration
@ComponentScan(basePackageClasses = BeanOverridingTest.class)
static class TestConfiguration{
    @Bean
    public BeanInterface beanA() {
        return new BeanA();
    }
}

此时会输出DEBUG级覆盖日志：

17:30:59.922 [Test worker] DEBUG o.s.b.f.s.DefaultListableBeanFactory --Overriding bean definition for bean 'beanA' with a different definition: ...

场景2：@Bean返回实现类类型

@Configuration
@ComponentScan(basePackageClasses = BeanOverridingTest.class)
static class TestConfiguration{
    @Bean
    public BeanA beanA() {
        return new BeanA();
    }
}

此时无任何覆盖相关日志输出。

核心原因 #

Spring在注册Bean定义时，会通过DefaultListableBeanFactory的registerBeanDefinition方法判断是否触发覆盖逻辑，关键在于Bean定义的等价性判定：

1. 等价性判定规则：Spring会对比Bean定义的核心属性，包括：

   • Bean的实际类型（beanClass）
   • 作用域（scope）
   • 懒加载配置（lazyInit）
   • 自动装配模式（autowireMode）
   • 候选Bean状态（autowireCandidate）
   • 优先级（primary）
   • 工厂方法/工厂Bean信息等

2. 场景1的判定结果：

   • 组件扫描生成的Bean定义，beanClass为BeanA（实现类）
   • @Bean方法返回接口，生成的Bean定义beanClass为BeanInterface（接口）
     两者类型差异明显，被判定为不等价，因此Spring输出DEBUG日志提示“覆盖了不同的Bean定义”。

3. 场景2的判定结果：

   • 组件扫描和@Bean方法生成的Bean定义，beanClass均为BeanA
   • 其余核心属性（作用域、懒加载等）完全一致
     两者被判定为等价，Spring认为无需执行实际覆盖操作，因此不会输出覆盖日志（仅会在TRACE级别日志中记录“用等价定义覆盖”，但默认TRACE级别未开启）。

补充说明 #

• 等价的Bean定义不会改变容器状态，因此Spring不会执行额外的覆盖逻辑。
• 若需查看等价定义的注册记录，可将日志级别调整为TRACE。

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