Spring项目作为Maven依赖引入时无法读取自身配置属性的解决方法

将包含大量业务逻辑的Spring项目A通过mvn install打包为Maven依赖引入Spring Boot项目B后，启动时报占位符解析错误：

Could not resolve placeholder 'variable.from.properties.file' in value '${variable.from.properties.file}'

核心原因是Spring Boot默认仅加载当前应用自身路径下的配置文件，作为jar包引入的项目A自带的properties配置不在默认扫描加载范围内，导致@Value、@ConfigurationProperties注入的属性找不到对应值。
项目A中属性注入示例代码如下：

@Value("${project.username}") 
private String username;

预期效果为引入依赖后项目A自动读取自身配置，无需在项目B中重复编写属性。

分两种场景处理，优先选择第一种规范改造方案，适合项目A需要长期作为公共依赖复用的场景。

方案1：改造项目A为Spring Boot自动配置模块（推荐） #

• 第一步：规范项目A的配置文件存放路径，不要直接放在resources根目录，避免和项目B的配置重名冲突，建议新建独立目录存放，例如resources/project-a/config/，将默认配置、多profile配置都放在该目录下，命名示例：
  • project-a.properties：默认配置
  • project-a-prod.properties：生产环境配置
  • project-a-dev.properties：开发环境配置
• 第二步：在项目A中编写自动配置类，通过@PropertySource注解指定自身配置文件的加载路径，支持多profile匹配：

@Configuration
@ComponentScan(basePackages = "com.xxx.projecta") // 替换为项目A的根包路径
@PropertySource(
    value = {
        "classpath:project-a/config/project-a.properties",
        "classpath:project-a/config/project-a-${spring.profiles.active:default}.properties"
    },
    ignoreResourceNotFound = true
)
public class ProjectAAutoConfiguration {
    // 可按需在类内定义项目A需要的@Bean
}

• 第三步：注册自动配置类，让Spring Boot启动时能自动扫描到jar包中的该配置类：
  • Spring Boot 2.7及以上版本：在resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中写入上述自动配置类的全限定名，例如com.xxx.projecta.config.ProjectAAutoConfiguration，多个配置类换行分隔即可。
  • Spring Boot 2.7以下版本：在resources/META-INF/spring.factories文件中添加配置：

    org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.xxx.projecta.config.ProjectAAutoConfiguration
    

改造完成后重新打包项目A，再引入项目B即可自动加载A的配置，无需在B中做任何额外配置。

方案2：在项目B中主动引入依赖jar内的配置（适合无法修改项目A源码的场景） #

如果没有项目A的修改权限，直接在项目B的启动类或任意配置类上添加@PropertySource注解，用Spring的classpath通配符扫描所有jar包内匹配路径的配置文件即可：

@SpringBootApplication
@PropertySource(
    value = {
        // 替换为项目A中配置文件在jar包内的实际路径，classpath*表示扫描所有jar包资源
        "classpath*:project-a/config/project-a-*.properties"
    },
    ignoreResourceNotFound = true
)
public class ProjectBApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProjectBApplication.class, args);
    }
}

• 配置加载优先级遵循Spring Boot原生规则：项目B自身定义的同名属性优先级高于jar包中项目A的默认配置，会自动覆盖A中的默认值，无需额外处理。
• 配置ignoreResourceNotFound = true是为了避免激活的profile没有对应配置文件时启动报错，此时会回退加载默认配置文件中的值。
• 上述方案对@Value注入、@ConfigurationProperties批量注入的属性都生效。

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