Maven Install失败：SpringBoot@PropertySource占位符解析异常求助

问题原因 #

执行mvn clean install时，Maven测试阶段未传入app.home环境变量/VM参数，导致Spring无法解析@PropertySource中的${app.home}占位符，抛出解析异常。

解决方案 #

1. 命令行直接传入参数 #

打包时在命令行指定app.home的值，测试阶段会自动读取该参数：

mvn clean install -Dapp.home=./config

将./config替换为你实际的外部配置文件所在目录。

2. 配置Maven Surefire插件默认参数 #

在pom.xml中配置surefire插件，给测试阶段默认注入app.home参数，避免每次命令行输入：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <!-- 测试阶段默认的外部配置目录 -->
                <systemPropertyVariables>
                    <app.home>./config</app.home>
                </systemPropertyVariables>
            </configuration>
        </plugin>
    </plugins>
</build>

配置后执行mvn clean install无需额外传参，测试阶段会自动使用配置的路径。

3. 给占位符设置默认值并忽略缺失 #

修改@PropertySource注解，为app.home添加默认值，同时允许配置文件不存在（避免打包时因文件缺失报错）：

@PropertySource(value = "file:${app.home:./config}/test.properties", ignoreResourceNotFound = true)

• ${app.home:./config}表示如果未传入app.home参数，默认使用./config目录
• ignoreResourceNotFound = true保证即使默认路径下没有test.properties，打包流程也能正常执行，运行时再指定实际路径即可

4. 测试阶段使用独立配置 #

如果测试不需要加载外部配置，可以在测试类中指定类路径内的默认配置，覆盖外部配置依赖：

@SpringBootTest
// 使用类路径下的测试默认配置
@TestPropertySource(locations = "classpath:test-default.properties")
public class YourTestClass {
    // 测试逻辑
}

这样测试阶段不会依赖外部的app.home参数，打包时跳过外部配置的加载。

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