Spring Boot自定义库配置属性无法解析问题求助

一、自动配置加载验证 #

• 检查库的META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件是否存在，文件内必须正确填写自动配置类的全限定名（Spring Boot 2.7+版本不再使用spring.factories）。
• 确认自动配置类上是否标注@Configuration和@EnableConfigurationProperties(CheckCommonProperties.class)，后者是关联属性类的关键。

二、属性类配置检查 #

• 验证CheckCommonProperties类的@ConfigurationProperties(prefix = "check-common")注解前缀是否与Demo项目application.yaml中的配置前缀完全一致。
• 属性类必须提供公共getter方法，Spring Boot依赖getter完成属性值绑定，缺失则无法解析。
• 属性类需通过@Component或自动配置类的@EnableConfigurationProperties注册到Spring容器，否则无法被识别。

三、Maven打包与依赖校验 #

• 库的pom.xml需包含spring-boot-autoconfigure依赖，若为starter库，需继承spring-boot-starter-parent或引入spring-boot-starter依赖。
• 禁止使用spring-boot-maven-plugin的repackage目标打包库（该目标生成可执行jar，无法被其他项目依赖），改用普通maven-jar-plugin或插件的compile目标。
• 核对Demo项目pom.xml中库的groupId、artifactId、version是否与Sonatype部署的完全一致，排除拼写错误。

四、属性文件加载确认 #

• 若库包含自定义属性文件（如check-common.properties），需在自动配置类或属性类上通过@PropertySource指定文件路径，否则不会自动加载。
• 检查属性文件是否位于src/main/resources目录，打包后需存在于jar包的BOOT-INF/classes下，可通过解压jar包验证。

五、IDE与依赖同步操作 #

• 执行Demo项目的mvn clean install命令，或在IDE中刷新Maven依赖，确保拉取到最新的库版本。
• 清理IDE缓存（如IntelliJ的「Invalidate Caches/Restart」），排除旧缓存导致的属性识别异常。

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