Spring Boot如何读取外部配置文件？解决内置BOOT目录优先级问题

这个场景我之前帮团队排查过好几次，核心问题其实和Spring Boot的配置加载优先级、打包逻辑有关——默认情况下，jar包同级的config目录配置优先级本应高于jar内部的配置，但你的情况没生效，大概率是启动参数或打包环节的小问题，下面给你几个靠谱的解决办法：

方法1：启动时显式指定外部配置目录 #

直接在启动命令里通过参数强制指定外部config的路径，这是最直接有效的方式：

• 如果想让外部配置完全覆盖jar内的配置，用--spring.config.location：

java -jar myapp.jar --spring.config.location=./config/

• 如果想保留jar内配置作为 fallback（外部配置只覆盖冲突的键值），用--spring.config.additional-location：

java -jar myapp.jar --spring.config.additional-location=./config/

方法2：调整Maven打包，避免外部config被打包进jar #

你提到jar内的BOOT目录包含了外部config的文件，这说明Maven构建时把main/resource/config下的内容打包进jar了。虽然这不影响优先级，但容易造成混淆，建议修改pom.xml，把config目录排除在jar包之外，同时确保tar.gz打包时保留外部config：

<build>
    <!-- 排除config目录，不打包进jar -->
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>3.3.1</version>
            <configuration>
                <excludes>
                    <exclude>config/**</exclude>
                </excludes>
            </configuration>
        </plugin>
        <!-- Spring Boot打包插件配置 -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <layout>ZIP</layout>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
    <!-- 确保tar.gz打包时将config目录复制到根目录 -->
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <targetPath>../</targetPath>
            <includes>
                <include>config/**</include>
            </includes>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
            <excludes>
                <exclude>config/**</exclude>
            </excludes>
        </resource>
    </resources>
</build>

这样打包后，jar里不会包含config目录，tar.gz会单独保留外部config文件夹，启动时Spring Boot会自动识别同级的config目录。

方法3：验证配置加载情况的小技巧 #

启动应用时加上--debug参数，Spring Boot会打印所有加载的配置文件路径，你可以直观看到是否读取了外部配置：

java -jar myapp.jar --debug

日志里会出现类似这样的输出：

Config file 'file:./config/application.yml' found
Config file 'jar:file:./myapp.jar!/BOOT-INF/classes/config/application.yml' found

如果外部配置文件的加载顺序在前面，就说明优先级生效了。

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