Spring Boot如何在application.properties内指定外部属性源路径（替代命令行参数）

开发者阿泽

2026-11-4

问题原因

`spring.config.location` 属于Spring Boot引导阶段的配置参数，需要在应用上下文初始化前就被解析。你打包在jar内部的`application.properties`是上下文启动后才会加载的配置源，此时再指定外部配置路径已经错过加载时机，因此配置完全不生效。
同时需要明确：`spring.config.additional-location`、`spring.config.location`这类配置加载入口的参数，仅在引导阶段（上下文初始化前）传入才会生效，无论如何都无法通过修改jar内部的`application.properties`来指定。

可行实现方案

根据是否能接受修改少量启动代码，分场景给出方案：

方案1：仅在配置文件中声明外部路径，无需改代码（Spring Boot 2.4+ 适用）

使用Spring Boot 2.4引入的spring.config.import配置导入机制，直接在项目自带的application.properties中添加以下配置：

# optional: 前缀表示外部文件不存在时不抛出异常，如需强制校验文件存在可去掉该前缀
spring.config.import=optional:file:/Users/tony/Desktop/override.properties

注意：该机制导入的外部属性源优先级低于导入它的内部application.properties，仅适合补充内部配置没有的属性，无法覆盖内部同名配置。

方案2：修改启动代码，实现外部配置覆盖内部配置（全版本适用）

如果需要外部override.properties的优先级高于内部配置，直接在启动类中通过注解或API指定外部路径，无需传命令行参数：

2.1 注解方式

在启动类上添加@PropertySource注解指定外部文件路径，同时调整优先级保证覆盖效果：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.PropertySource;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;

@SpringBootApplication
// 指定外部文件路径，必须加file:前缀表示从操作系统文件系统加载
@PropertySource("file:/Users/tony/Desktop/override.properties")
// 提升外部配置优先级为最高，确保覆盖内部application.properties的同名属性
@Order(Ordered.HIGHEST_PRECEDENCE)
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

2.2 API方式

如果不想用注解，也可以在启动类的main方法中通过SpringApplicationAPI添加外部配置位置：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication app = new SpringApplication(MyApplication.class);
        // 添加外部配置文件，优先级高于默认的classpath下application.properties
        app.addConfigLocation("file:/Users/tony/Desktop/override.properties");
        app.run(args);
    }
}

注意事项

所有外部文件路径必须加file:前缀，否则会被默认当作classpath路径解析
Windows系统下路径写法为file:C:/Users/tony/Desktop/override.properties，注意盘符前的斜杠
不要尝试在内部application.properties中配置spring.config.location或spring.config.additional-location，这两类参数本身就是用来指定配置加载入口的，写在默认配置文件中永远不会被读取

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