Spring Boot读取外部Properties文件返回null问题求助

看起来你是想把配置文件移到Jar包外部，方便修改后直接生效，但现在遇到了读取返回null的问题。这通常是因为你还在沿用读取类路径资源的方式（比如getResourceAsStream()），而外部文件并不在类路径范围内，导致找不到文件进而返回null。下面分场景给你几种靠谱的解决方案：

一、普通Java项目（非Spring框架） #

1. 直接指定绝对路径加载 #

这是最直接的方式，适合配置文件路径固定的场景：

Properties server_1 = new Properties();
try (FileInputStream fis = new FileInputStream("/opt/config/server_1.properties")) {
    server_1.load(fis);
    String serverIp = server_1.getProperty("server.ip");
    // 后续业务逻辑
} catch (IOException e) {
    System.err.println("加载配置文件失败：" + e.getMessage());
    e.printStackTrace();
}

2. 基于Jar所在目录的相对路径加载 #

如果希望配置文件和Jar包放在同一目录（或子目录），可以动态获取Jar的运行目录，再拼接配置文件路径：

Properties server_1 = new Properties();
try {
    // 获取Jar文件所在的父目录
    String jarDir = new File(
        YourMainClass.class.getProtectionDomain().getCodeSource().getLocation().toURI()
    ).getParent();
    // 配置文件放在Jar同目录下，若在子目录可改为 jarDir + File.separator + "config/server_1.properties"
    String configFilePath = jarDir + File.separator + "server_1.properties";
    
    try (FileInputStream fis = new FileInputStream(configFilePath)) {
        server_1.load(fis);
        String serverIp = server_1.getProperty("server.ip");
    }
} catch (Exception e) {
    System.err.println("加载外部配置失败：" + e.getMessage());
    e.printStackTrace();
}

注意替换YourMainClass为你的项目主类名称，这样不管Jar放在哪个路径，都能找到同目录的配置文件。

3. 通过系统参数传递配置路径 #

这种方式灵活性更高，启动程序时可以动态指定配置文件位置：
启动命令示例：

java -jar your-app.jar -Dconfig.path=/opt/config/server_1.properties

代码中读取逻辑：

String configPath = System.getProperty("config.path");
// 若未指定系统参数， fallback到Jar同目录的配置文件
if (configPath == null || configPath.isEmpty()) {
    configPath = new File(YourMainClass.class.getProtectionDomain().getCodeSource().getLocation().toURI()).getParent() + File.separator + "server_1.properties";
}

Properties server_1 = new Properties();
try (FileInputStream fis = new FileInputStream(configPath)) {
    server_1.load(fis);
} catch (Exception e) {
    e.printStackTrace();
}

二、Spring/Spring Boot项目 #

如果是Spring Boot项目，不用自己写Properties加载逻辑，框架已经帮你封装好了便捷方案：

1. 自动识别外部配置 #

Spring Boot默认会扫描以下位置的配置文件（优先级从高到低）：

• Jar包所在目录的config/子目录
• Jar包所在目录
• classpath下的config/子目录
• classpath根目录

你只需要把application.properties或自定义配置文件放到Jar同目录的config/文件夹里，启动时框架会自动加载外部配置，覆盖类路径内的默认配置。

2. 手动指定配置路径 #

启动Jar时通过参数明确指定外部配置文件的位置：

# 指定单个配置文件
java -jar your-app.jar --spring.config.location=file:./server_1.properties
# 或者指定目录，加载目录下所有properties文件
java -jar your-app.jar --spring.config.location=file:./config/

如果需要热加载配置（修改后无需重启服务），可以引入spring-boot-devtools依赖，不过生产环境建议谨慎使用该功能。

排查读取返回null的常见原因 #

• 路径错误：打印你拼接的配置文件完整路径，确认文件是否真的存在于该位置
• 权限问题：确保运行程序的用户拥有该配置文件的读取权限
• 错误的加载方式：不要使用getClass().getResourceAsStream("server_1.properties")，这种方式只能读取类路径内的资源，外部文件无法通过该方法获取

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