Spring中Bean修饰符、隐藏、方法注入及冲突规避问题咨询

代码示例 #

Foo类 #

@RequiredArgsConstructor
public class Foo {
    @Getter
    private final List<Integer> list;
}

Bar类 #

@RequiredArgsConstructor
public class Bar {
    @Getter
    private final List<String> list;
}

FooConfig配置类 #

@Configuration
public class FooConfig {

    @Bean
    public Foo foo() {
        return new Foo(innerList()); // 不确定调用的是哪个innerList()，取决于配置加载顺序
    }

    @Bean
    protected List<Integer> innerList() {
        // 修饰符protected无效，返回Integer类型列表
        ArrayList<Integer> result = new ArrayList<>();
        result.add(1);
        return result;
    }

}

BarConfig配置类 #

@Configuration
public class BarConfig {

    @Bean
    public Bar bar() {
        return new Bar(innerList()); 
    }

    @Bean
    protected List<String> innerList() {
        // 另一个同名的protected Bean，返回String类型列表
        ArrayList<String> result = new ArrayList<>();
        result.add("string");
        return result;
    }
}

Test测试类 #

@Component
public class Test {

    @Autowired
    @Getter
    private Bar bar;


    @Autowired
    @Getter
    private Foo foo;


    public static void main(String[] args) {
        // 初始化Spring上下文
        // 第二个配置类的innerList()总是覆盖第一个，导致BarConfig.innerList()生效
        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(FooConfig.class,
                BarConfig.class, Test.class);

// 即使关闭BeanDefinitionOverriding也无济于事
//ctx.setAllowBeanDefinitionOverriding(false);

        Test test = ctx.getBean(Test.class);
        Assert.assertEquals(test.getBar().getList().get(0).getClass(), String.class);
        Assert.assertEquals(test.getFoo().getList().get(0).getClass(), Integer.class);// Foo实例注入了错误的innerList()，抛出ClassCastException
    }
}

技术问题解答 #

1. 被Spring AOP代理后，Bean方法的public与protected修饰符是否完全等效？ #

不完全等效，但在Spring容器管理Bean的场景下，二者的可见性差异被代理逻辑抹平了一部分：

• Spring默认用CGLIB代理配置类，代理类继承原配置类，因此protected方法可被代理类访问并增强；若用JDK动态代理（基于接口），则只能代理public方法。
• 从Bean注册角度看，无论Bean方法是public还是protected，Spring都会将其注册为容器内的Bean，且Bean可见性是容器级别的——你代码里的protected修饰符没起到“隐藏”作用，就是因为Spring把它当成普通Bean注册了。
• 另外，protected方法在非继承场景下无法被外部直接调用，但Spring代理后，容器依然能通过反射或代理实例调用该方法生成Bean。

2. 是否存在将Bean隐藏在配置类内部的方法？ #

有几种方式可实现类似“隐藏”，不让该Bean被容器内其他组件直接注入：

• 去掉@Bean注解，直接调用普通方法：把innerList()的@Bean注解去掉，仅在当前配置类的Bean方法里调用，这样该列表不会被注册为容器Bean，仅作为当前Bean的内部依赖存在，这是最直接的方式。
• 使用私有方法生成实例：如果不需要将内部依赖注册为容器Bean，直接写私有方法生成实例，仅在当前配置类内部使用。
• 配置类内部静态类封装Bean定义：把内部Bean的定义放到配置类的静态内部类中，虽不是严格意义的隐藏，但能减少跨配置类的同名冲突概率。

3. 我是否触发了Method Injection（方法注入）？ #

没有触发Spring的方法注入（Method Injection）。
Spring的方法注入特指通过@Lookup注解或XML配置的lookup-method实现的延迟注入，目的是解决单例Bean依赖原型Bean时的重复获取问题。
你代码里的innerList()调用是普通方法调用，但因配置类被Spring代理，实际执行时会去容器中查找名为innerList的Bean实例——这是Spring对@Bean方法的代理逻辑（确保每次调用返回容器中的Bean实例），不属于方法注入范畴。

4. 大型项目中Bean方法易出现同名情况，有哪些最佳实践可避免注入错误Bean？ #

• 给Bean指定唯一名称：在@Bean注解中显式指定name属性，比如@Bean("integerInnerList")和@Bean("stringInnerList")，调用或注入时明确指定名称。
• 使用@Qualifier限定注入：在需要注入的地方加@Qualifier("beanName")，精准定位目标Bean；配置类内部也可通过@Autowired @Qualifier("xxx")注入后再使用，而非直接调用方法。
• 采用参数注入替代方法调用：在Bean方法中通过参数注入依赖，比如：

  @Bean
  public Foo foo(@Qualifier("integerInnerList") List<Integer> list) {
      return new Foo(list);
  }
  

• 统一Bean命名规范：采用“类型+用途”的命名方式，比如userIdList、orderNameList，避免innerList这类模糊名称。
• 按业务模块拆分配置类：不同模块的配置类放在不同包下，减少跨模块Bean同名概率；同时用@ComponentScan过滤规则，避免不必要的Bean扫描。
• 禁止BeanDefinitionOverriding：开启spring.main.allow-bean-definition-overriding=false，遇到同名Bean直接抛出异常，提前发现冲突，避免运行时报错。

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