Spring自定义AutoConfiguration未被应用检测到的问题求助

针对你遇到的自定义自动配置库中Refresher Bean未创建、@PostConstruct方法不执行的问题，以下是逐一排查和解决的步骤：

1. 校验spring.factories文件的正确性 #

• 路径检查：确保文件位于src/main/resources/META-INF/spring.factories，不要放在java源码目录下，也不要拼错META-INF名称。
• 类名检查：确认com.bla.PropertiesRefresherAutoConfiguration是配置类的完整全限定名，包名、类名大小写、拼写必须完全匹配实际代码。
• 换行符检查：文件中\后面不能有空格，否则会导致Spring解析类名失败，正确格式应为：

  org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  com.bla.PropertiesRefresherAutoConfiguration
  

2. 确认RefreshProperties配置类的合法性 #

RefreshProperties必须正确绑定配置属性，否则会导致@ConditionalOnProperty判断失效，甚至移除注解后也可能因为属性类加载问题影响配置类生效：

@ConfigurationProperties(prefix = "properties.refresh")
public class RefreshProperties {
    public static final String PROPERTIES_AUTO_REFRESH = "properties.refresh";
    private boolean enabled;

    // 必须提供getter/setter，否则Spring无法绑定属性
    public boolean isEnabled() {
        return enabled;
    }

    public void setEnabled(boolean enabled) {
        this.enabled = enabled;
    }
}

3. 检查主应用的依赖引入 #

• 确认主应用的构建文件（pom.xml/build.gradle）中已正确引入自定义库依赖，版本、坐标无错误。
• 执行依赖树命令排查依赖是否成功加载：
  • Maven：mvn dependency:tree
  • Gradle：gradle dependencies

4. 开启自动配置调试日志定位问题 #

在主应用的application.yaml中添加日志配置，查看自动配置的执行细节：

logging:
  level:
    org.springframework.boot.autoconfigure: DEBUG

启动应用后，搜索日志中PropertiesRefresherAutoConfiguration相关内容：

• 如果日志显示配置类未被加载，说明spring.factories或依赖有问题；
• 如果显示Did not match condition，说明属性绑定或@ConditionalOnProperty配置有误。

5. 检查Refresher类的基础合法性 #

• 确保Refresher是public类，且拥有public无参构造方法，Spring需要通过反射实例化Bean；
• 确认@PostConstruct注解的包正确：Spring Boot 2.x用javax.annotation.PostConstruct，Spring Boot 3.x用jakarta.annotation.PostConstruct，不要导错包。

6. 手动导入配置类验证 #

如果以上步骤都没问题，可在主应用的启动类上手动导入配置类，验证是否能创建Bean：

@SpringBootApplication
@Import(PropertiesRefresherAutoConfiguration.class)
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

如果手动导入后Bean能正常创建，说明自动配置的加载逻辑存在问题，需重新检查spring.factories和依赖传递。

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