本文围绕 Spring @Bean 方法可见性全解析展开，重点分析从 public 到 private 的影响，并结合设计要点与实战要点，帮助开发者在大型应用中稳定地管理 Bean 的生命周期。Spring 框架中，@Bean 方法的可见性直接关系到容器对工厂方法的控制、代理行为以及 Bean 的生命周期管理。
1. 可见性对 Spring @Bean 的根本影响
在带代理的配置类中，方法的可见性决定了 Spring 采用哪种方式来拦截和调用该方法，从而影响单例、延迟初始化、以及跨 Bean 的互相引用。
在 public 方法的设计下，Spring 能通过 CGLIB（或 JDK 动态代理）对方法进行覆盖与拦截，确保在容器中对同一 Bean 的引用保持一致性。
从 public 到 private 的影响 在模型上体现在代理能力、方法调用路径以及是否能够被容器注册为 Bean，这直接决定了依赖注入的稳定性与可维护性。
1.1 为什么方法可见性重要
当 @Bean 方法是 public 时，Spring 可以通过 CGLIB 代理对方法进行改写，确保在跨 Bean 注入时返回同一个实例，避免重复创建，保护 单例 的语义。
如果方法不可见，例如 private，配置类的代理就无法覆盖该方法的调用，导致该方法可能不会被配置为 Bean，从而丢失对该对象的统一管理与依赖注入的一致性。
1.2 公共方法与代理的关系
在带有 @Configuration 的类中，代理 Bean 方法的调用确保了从容器中获取同一个 Bean 实例，而不是每次都执行方法体，避免重复创建。
当配置类中的一个 Bean 依赖另一个 Bean 时，容器会通过代理拦截对该方法的调用，返还上下文中已经创建的 Bean，确保依赖关系的正确性。
1.3 私有方法的限制与风险
将 @Bean 方法设为 private，虽然 Java 语法允许，但在运行期，Spring 的代理无法覆盖，导致以下风险：Bean 注册失败、依赖注入失效、以及对单例语义的破坏。
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class AppConfig {@Beanprivate ServiceB serviceB() {return new ServiceB();}
}
从运行时角度看，容器可能不会将该方法注册为 Bean，从而影响后续的依赖注入与初始化顺序，实际行为也可能随 Spring 版本而有所差异，因此应避免将 @Bean 方法设为 private。
2. 设计要点：如何在实践中选择合适的可见性
在设计阶段需要综合考虑可维护性、性能与未来扩展性，合理选择方法可见性，同时理解配置代理机制对行为的影响。
通过正确配置 proxyBeanMethods 与方法可见性，可以实现更稳定的 BeanLifecycle 管理与跨 Bean 协作。
2.1 使用 proxyBeanMethods 与行为
@Configuration 的属性 proxyBeanMethods 决定了是否对 @Bean 方法进行代理。默认情况下，proxyBeanMethods=true，这意味着方法调用会被代理以确保单例引用与跨 Bean 内部调用的正确行为。
如果将 proxyBeanMethods=false，则配置类中的同类方法调用将直接执行方法体，而不是通过容器获取 Bean。这在某些极致性能场景中有帮助，但要非常小心对依赖关系的影响。
@Configuration(proxyBeanMethods = true)
public class AppConfig {@Beanpublic ServiceA serviceA() {return new ServiceA();}@Beanpublic ServiceB serviceB() {// 通过代理调用 serviceA，确保返回同一个实例return new ServiceB(serviceA());}
}
2.2 @Bean 方法的可见性与跨类引用
在需要跨配置类引用 Bean 时，public @Bean 方法配合代理机制可以确保引用的一致性。
如果某些场景要求减少可见性，务必确保不破坏代理拦截与跨 Bean 访问的前提条件，必要时使用参数注入而非直接方法调用。
@Configuration
public class OtherConfig {@Beanpublic Helper helper(ServiceA a) {return new Helper(a);}
}
3. 实战代码对比与要点
3.1 公共 @Bean 的对比示例
下面示例展示了一个常见场景：公共 @Bean 方法用于构建应用的核心组件，便于容器对其统一管理。
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class AppConfig {@Beanpublic Repository repository() {return new InMemoryRepository();}@Beanpublic Service service(Repository repo) {return new Service(repo);}
}
在该场景中，容器会确保 repository 与 service 的单例关系，并且在注入时提供稳定的依赖。
3.2 私有 @Bean 的示例与容器行为
下面示例展示了将 @Bean 方法设为 private 的情况，以及它可能带来的风险。
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class AppConfig {@Beanprivate Repository repository() {return new InMemoryRepository();}@Beanpublic Service service(Repository repo) {return new Service(repo);}
}
在上述代码中，private repository() 可能不会被容器识别为 Bean，从而导致 service 注入缺失或运行时异常，实际效果取决于 Spring 的内部处理与版本差异，因此应避免使用 private 修饰 @Bean 方法。
