Spring Boot中@Component类的@PostConstruct方法未调用问题

Hey there! Let's dig into why your @PostConstruct method isn't firing up. I've tackled similar head-scratchers with Spring Boot before, so let's break this down step by step:

First, let's rule out the most common culprits: #

1. You're using the wrong @PostConstruct package (critical for Spring Boot 3.x!)

Spring Boot 3.x switched from Java EE to Jakarta EE, which changed the package for this annotation:

• For Spring Boot 2.x: Use javax.annotation.PostConstruct
• For Spring Boot 3.x: Must use jakarta.annotation.PostConstruct
  If you imported the wrong one, Spring won't recognize the annotation at all—double-check your imports!

2. Your TestBean isn't in Spring's component scan range

Spring only picks up @Component classes that are in the same package (or sub-packages) as your main Spring Boot application class. For example:

• If your main class is in com.myapp, TestBean needs to be in com.myapp or com.myapp.beans (not a totally separate package like com.other).
• If it's outside that range, add @ComponentScan(basePackages = "com.your.testbean.package") to your main application class to tell Spring where to look.

3. Missing dependency (common for minimal Spring Boot projects)

@PostConstruct is part of the Jakarta/Javax annotations spec. For minimal projects:

• Spring Boot 3.x: You need to explicitly add this dependency to your pom.xml:

  <dependency>
      <groupId>jakarta.annotation</groupId>
      <artifactId>jakarta.annotation-api</artifactId>
  </dependency>
  

• Spring Boot 2.x: The base spring-boot-starter usually includes javax.annotation-api, but if it's missing for some reason, add:

  <dependency>
      <groupId>javax.annotation</groupId>
      <artifactId>javax.annotation-api</artifactId>
      <version>1.3.2</version>
  </dependency>
  

4. You're manually instantiating TestBean instead of letting Spring manage it

If you're creating an instance with new TestBean() somewhere in your code, that object isn't managed by the Spring container—so @PostConstruct won't run. You need to get the bean from Spring:

• Use @Autowired to inject it into another Spring-managed class (like your main application)
• Or fetch it via ApplicationContext.getBean(TestBean.class)

Let's test with a working example #

Here's how your code should look to ensure everything works:

TestBean.java (Spring Boot 3.x version):

import jakarta.annotation.PostConstruct;
import org.springframework.stereotype.Component;

@Component
public class TestBean {
    private int a = 1;

    public TestBean() {
        System.out.println("TestBean constructor executed");
    }

    @PostConstruct
    public void init() {
        this.a = 100;
        System.out.println("init method executed - a updated to 100");
    }

    public void testMethod() {
        System.out.println("testMethod executed - a value: " + a);
    }
}

Main Application Class:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MyApp implements CommandLineRunner {

    @Autowired
    private TestBean testBean;

    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }

    @Override
    public void run(String... args) {
        testBean.testMethod();
    }
}

When you run this, you should see logs in this order:

TestBean constructor executed
init method executed - a updated to 100
testMethod executed - a value: 100

Final Check #

Also, look for this line in your logs to confirm Spring is actually creating the bean:
Creating shared instance of singleton bean 'testBean'
If you don't see this, Spring isn't scanning or recognizing your TestBean at all—go back to the component scan check.

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