@PostConstruct 用于在依赖注入完成后、Bean 对外可用前自动执行一次初始化方法；要求方法非私有、无参、非静态，且类为 Spring 管理的 Bean。

@PostConstruct 是 Java EE（现为 Jakarta EE）规范定义的注解，Spring 完全支持它。它的作用是在 Spring 容器完成 Bean 的实例化、属性注入（即依赖注入）之后，但在该 Bean 被放入容器供其他组件使用之前，**自动执行一次初始化方法**。

执行时机很明确：在依赖注入完成后，但 Bean 尚未对外可用时

具体顺序如下：

• Spring 调用构造函数创建 Bean 实例（此时字段还是 null 或默认值）
• Spring 执行所有 @Autowired、@Value、@Resource 等注入操作（字段/Setter/构造参数都已赋值）
• Spring 检查并调用被 @PostConstruct 标记的**无参、非静态、非私有**方法（只能有一个）
• 该方法执行完毕后，Bean 才算“初始化完成”，正式加入 Spring 容器，可被其他 Bean 注入或通过 ApplicationContext 获取

必须满足的条件才能生效

Spring 不会自动扫描任意方法，以下几点缺一不可：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 方法必须是 public / protected / package-private（不能是 private）
• 方法必须 无参数（不能有入参，也不能是 varargs）
• 方法不能是 static
• 类必须是 Spring 管理的 Bean（例如加了 @Component、@Service，或通过 @Bean 注册）
• 项目需启用注解驱动（通常 @EnableAnnotationDriven 已由 @SpringBootApplication 隐含启用）

和其它初始化方式的区别

别把它和这些机制混淆：

立即学习“Java免费学习笔记（深入）”；

• 构造函数：早于依赖注入，无法访问 @Autowired 字段（仍是 null）
• InitializingBean.afterPropertiesSet()：功能类似，但属于 Spring 特定接口，侵入性强；@PostConstruct 更标准、更轻量
• @Bean(initMethod = "...")：适用于工厂方法注册的 Bean，粒度在方法级；@PostConstruct 绑定在实例方法上，更直观
• @EventListener(ContextRefreshedEvent.class)：触发更晚，整个上下文刷新完才执行，且可能多次调用（如有多个上下文）

一个典型用法示例

（注意：字段已注入，可安全使用）

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository; // 注入已完成

    private List<User> cachedUsers;

    @PostConstruct
    public void init() {
        System.out.println("正在预加载用户缓存...");
        this.cachedUsers = userRepository.findAll(); // 安全调用
    }
}