Spring Boot中ResourceBundle优先读取外部application.properties的问题

嘿，我完全懂你碰到的这个坑——用ResourceBundle.getBundle("application")读配置时，它默认只会从类路径里找资源，所以Jar包自带的application.properties总能被优先读到，完全无视了Jar旁边的外部配置文件。想要实现Spring那种外部配置优先、内部配置兜底的逻辑，得给ResourceBundle加些自定义逻辑才行，下面给你两个实用的解决方案：

方案1：自定义ResourceBundle.Control（推荐） #

ResourceBundle.getBundle()方法支持传入自定义的Control对象，我们可以重写它的资源查找逻辑，让它先找外部文件，找不到再回退到类路径的资源。

实现自定义Control #

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ResourceBundle;

public class ExternalFirstResourceControl extends ResourceBundle.Control {

    @Override
    public ResourceBundle newBundle(String baseName, java.util.Locale locale, String format, ClassLoader loader, boolean reload) throws IllegalAccessException, InstantiationException, IOException {
        // 构建配置文件名（兼容多语言/多环境，比如application_en.properties）
        String bundleName = toBundleName(baseName, locale);
        String resourceName = toResourceName(bundleName, "properties");
        
        // 优先查找Jar包同级目录的外部配置文件
        File externalFile = new File(System.getProperty("user.dir"), resourceName);
        if (externalFile.exists() && externalFile.isFile()) {
            try (InputStream is = new FileInputStream(externalFile)) {
                return new PropertyResourceBundle(is);
            }
        }
        
        // 外部文件不存在时，用默认逻辑加载类路径（Jar内部）的配置
        return super.newBundle(baseName, locale, format, loader, reload);
    }
}

使用方式 #

调用ResourceBundle.getBundle()时传入自定义的Control即可：

ResourceBundle bundle = ResourceBundle.getBundle("application", new ExternalFirstResourceControl());
String x = bundle.getString("x");

方案2：手动加载并合并配置（更直观） #

如果不想自定义Control，也可以手动分别加载外部和内部的配置文件，然后合并——先加载内部配置作为兜底，再加载外部配置覆盖相同的键值对。

实现加载逻辑 #

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;

public class ConfigLoader {
    public static Properties loadConfig() throws IOException {
        Properties configProps = new Properties();
        
        // 第一步：加载Jar内部的配置（作为默认值）
        try (InputStream internalStream = ConfigLoader.class.getClassLoader().getResourceAsStream("application.properties")) {
            if (internalStream != null) {
                configProps.load(internalStream);
            }
        }
        
        // 第二步：加载外部配置，覆盖内部的相同键
        File externalConfig = new File(System.getProperty("user.dir"), "application.properties");
        if (externalConfig.exists()) {
            try (InputStream externalStream = new FileInputStream(externalConfig)) {
                configProps.load(externalStream);
            }
        }
        
        return configProps;
    }
}

使用方式 #

直接调用工具类加载配置，然后获取值：

Properties config = ConfigLoader.loadConfig();
String x = config.getProperty("x");

一些注意点 #

• System.getProperty("user.dir")在java -jar启动时，指向的是Jar文件所在的目录，正好符合你外部配置放在Jar旁的需求；但在IDE中运行时，它指向项目根目录，这时候要把外部配置放在项目根目录才能被读到。
• 如果你的外部配置不在Jar同级目录，可以自行修改externalFile的路径（比如指定为/opt/config/application.properties）。
• 要是需要支持多环境配置（比如application-dev.properties），只需要调整代码中的配置文件名即可。

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