Spring Boot可执行Jar的PropertiesLauncher命令行参数失效问题

关键前提：确认Launcher类型 #

Spring Boot的-Dloader.path仅对PropertiesLauncher生效，默认的JarLauncher会完全忽略该参数，这是多数人遇到此问题的核心原因。

具体解决步骤 #

1. Gradle配置启用PropertiesLauncher #

在pets-app模块的build.gradle中添加以下配置：

springBoot {
    launcher.set("org.springframework.boot.loader.PropertiesLauncher")
    mainClass.set("com.yourpackage.PetsAppApplication") // 替换为你的主类全路径
}

或者通过bootJar任务显式配置Manifest：

bootJar {
    manifest {
        attributes(
            'Main-Class': 'org.springframework.boot.loader.PropertiesLauncher',
            'Start-Class': 'com.yourpackage.PetsAppApplication'
        )
    }
}

重新构建可执行Jar后，loader.path参数才会被识别。

2. 正确构造启动命令 #

将外部配置目录加入loader.path，同时确保Spring Boot能扫描到自定义配置文件：

# 加载conf/default下的所有配置文件
java -Dloader.path=./conf/default -jar pets-app-0.0.1-SNAPSHOT.jar

如果random.properties未被自动加载，需要在application.properties中显式引入：

spring.config.import=classpath:random.properties

或者通过启动参数指定：

java -Dloader.path=./conf/default -Dspring.config.import=classpath:random.properties -jar pets-app-0.0.1-SNAPSHOT.jar

3. 匹配Profile配置 #

由于你使用默认profile（未指定自定义active profile），外部配置文件需保持名称为application.properties和random.properties，或者命名为application-default.properties来匹配默认profile优先级。

4. 验证配置加载 #

添加日志参数查看配置加载详情，确认外部文件是否被扫描：

java -Dloader.path=./conf/default -Dlogging.level.org.springframework.boot.context.config=DEBUG -jar pets-app-0.0.1-SNAPSHOT.jar

在日志中搜索Adding property source关键字，检查是否包含conf/default路径下的配置文件。

5. 替代方案：直接指定配置路径 #

若loader.path仍有问题，可绕过它直接用spring.config.location指定外部配置，无需依赖PropertiesLauncher：

java -jar pets-app-0.0.1-SNAPSHOT.jar --spring.config.location=classpath:/,./conf/default/

此命令会同时加载Jar内的默认配置和外部conf/default下的配置，外部配置优先级更高。

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