SpringBoot运行Jar包时如何覆盖I18N的messages.properties？

下面提供几种实用方案，让Jar包使用者可以轻松自定义本地化消息：

方案1：利用Spring Boot默认外部配置目录 #

Spring Boot默认会优先加载Jar包同级config目录下的资源文件，操作步骤如下：

• 将自定义的message.properties（或带语言后缀的文件，如message_zh_CN.properties）放在Jar包所在目录的config文件夹中，保持和Jar内资源包相同的目录结构（比如Jar内是src/main/resources/message.properties，外部就放在config/message.properties）。
• 直接运行Jar包：java -jar your-app.jar，Spring Boot会自动优先读取外部config目录下的资源，覆盖Jar内的同名消息。

如果需要指定非默认的外部目录，运行时添加参数：

java -jar your-app.jar --spring.config.additional-location=file:/path/to/your/custom-resource-dir/

方案2：通过系统参数指定资源包路径 #

使用者可以在运行Jar时直接通过系统参数指定自定义资源包的位置，灵活度更高：

• 单个资源包路径：

java -jar your-app.jar -Dspring.messages.basename=file:/path/to/your/custom-message

这里的custom-message是资源包的前缀（比如你的自定义文件是custom-message.properties、custom-message_zh_CN.properties）。

• 同时加载内部和外部资源（外部优先覆盖）：

java -jar your-app.jar -Dspring.messages.basename=classpath:message,file:/path/to/custom-message

未在外部定义的消息会自动使用Jar内的默认值。

方案3：自定义MessageSource实现灵活控制 #

如果需要更复杂的加载逻辑（比如动态刷新、多目录优先级），可以在项目中自定义MessageSource Bean：

@Configuration
public class CustomMessageConfig {
    @Bean
    public MessageSource messageSource() {
        ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();
        // 读取系统参数传递的外部路径，默认使用Jar内资源
        String customPath = System.getProperty("custom.message.path", "classpath:message");
        messageSource.setBasenames(customPath, "classpath:message");
        messageSource.setDefaultEncoding("UTF-8");
        // 缓存时间，生产环境可设为3600或更久，开发时设为0方便实时刷新
        messageSource.setCacheSeconds(0);
        return messageSource;
    }
}

使用者运行时只需传递自定义路径参数即可：

java -jar your-app.jar -Dcustom.message.path=file:/path/to/your/custom-resources/message

注意事项 #

• 资源文件命名需遵循Spring本地化规则：默认文件为message.properties，语言特定文件用message_{语言}_{地区}.properties格式（如message_en_US.properties）。
• 确保自定义资源文件使用UTF-8编码，并在配置中指定编码，避免乱码问题。
• 外部资源包中只需定义需要覆盖的消息key，未定义的会自动使用Jar内的默认值，无需复制全部内容。

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