理解@Bean 方法的作用
在spring框架中，@bean注解用于指示一个方法将返回一个由spring ioc容器管理的对象（bean）。这些方法通常存在于标有@configuration注解的配置类中。通过这种方式，开发者可以使用纯java代码来定义和配置应用程序的组件，替代传统的xml配置。
例如：
@Configuration
public class AppConfig {
@Bean
public MyComponent firstComponent() {
return new MyComponent();
}
@Bean
public AnotherService anotherService(MyComponent myComponent) {
return new AnotherService(myComponent);
}
}
@Bean 方法可见性之辨：public 与其他修饰符
当我们在@Bean方法前使用可见性修饰符（如public, protected, default (包私有), private）时，其对Spring容器行为的影响是开发者关注的焦点。尽管Spring的反射机制理论上可以访问非public方法（通过setAccessible(true)），但在实际应用中，public修饰符是官方文档和社区推荐的标准。
核心观点：Spring在选择工厂方法时，通常会优先考虑public方法。
这意味着，即使一个非public的@Bean方法在某些情况下可能被Spring成功识别并用于创建Bean，使用public修饰符能够提供更明确、更可靠的行为。这种“优先级”可能体现在以下几个方面：
- 反射机制的简化与效率： public方法是Java中最容易被反射机制访问的。虽然Spring可以强制访问非public方法，但这可能引入额外的开销或在某些安全管理器配置下受限。
- CGLIB代理的兼容性： 当@Configuration类被Spring进行CGLIB代理时（用于实现@Bean方法之间的内部方法调用拦截，以确保单例语义），CGLIB通常要求被代理的方法是public的。虽然Spring可能在某些情况下回退到JDK动态代理或其他机制，但使用public可以确保最广泛的兼容性和最常见的代理行为。
- 避免潜在的歧义： 在复杂配置中，如果存在多个可能生成同一类型Bean的方法，或者方法签名存在微妙差异时，Spring对public方法的优先选择可以帮助避免不确定性，确保容器按照预期行为工作。
- 一致性与可读性： Spring官方文档和绝大多数社区示例都将@Bean方法声明为public。遵循这一约定可以提高代码的一致性、可读性和可维护性，方便其他开发者理解和接手项目。
纯Java配置下的影响
对于仅使用Java配置的项目，虽然不再涉及与XML配置混合时可能出现的可见性问题（例如，旧版Spring JavaConfig中，XML引用Java配置的Bean时对可见性有特定要求），但上述关于public方法优先级的原则依然适用。使用public可以确保你的Java配置在未来的Spring版本升级或更复杂的场景中依然保持健壮和可预测。
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
最佳实践与建议
基于上述分析，强烈建议始终将@Bean方法声明为public。
示例：
@Configuration
public class ApplicationConfiguration {
// 推荐：使用 public 修饰符
@Bean
public DataSource myDataSource() {
// 配置数据源
return new org.springframework.jdbc.datasource.DriverManagerDataSource();
}
// 不推荐：虽然可能工作，但存在潜在问题和不确定性
// @Bean
// MyService myService() { // default (package-private) visibility
// return new MyService();
// }
// 不推荐：私有方法通常不应作为 @Bean 方法
// @Bean
// private MyRepository myRepository() {
// return new MyRepository();
// }
}
注意事项：
- 不要过度设计可见性： @Bean方法的目的是向Spring容器提供Bean实例，它们通常不被应用程序的其他部分直接调用。因此，没有必要为了封装性而限制其可见性，public在这里并不会破坏封装原则。
- 保持简单和一致： 遵循Spring社区的普遍实践，使用public修饰符，可以减少不必要的调试时间和潜在的兼容性问题。
总结
在Spring Java配置中，@Bean方法的可见性看似是一个小细节，但它反映了Spring容器内部Bean创建和管理的机制。尽管Spring具备一定的灵活性来处理非public方法，但将@Bean方法明确声明为public，不仅符合官方文档的指导，更能确保Bean工厂方法的优先级、与CGLIB代理的兼容性以及整体配置的健壮性与可维护性。因此，始终使用public修饰符是编写高质量Spring Java配置的最佳实践。
