Spring Boot打包JAR后message_en_US.properties无法读取问题

我帮你排查下这个问题——在IDE里正常但打包成JAR就失效，这种情况大多是配置细节或者资源匹配的问题，咱们一步步来：

1. 先检查最容易忽略的文件名匹配问题 #

你配置的basename是classpath:messages，Spring会自动寻找格式为messages_<locale>.properties的文件，但你的文件是message_en_US.properties（注意少了末尾的s）！

IDE环境下可能因为宽松的类路径扫描机制，不小心识别到了这个文件，但打包成JAR后，Spring会严格按照basename前缀匹配资源，所以找不到对应的文件。

解决办法：把你的配置文件重命名为messages_en_US.properties，确保和basename的前缀完全一致。

2. 调整ReloadableResourceBundleMessageSource的配置适配JAR环境 #

如果文件名没问题，那可能是ReloadableResourceBundleMessageSource的默认行为不适合JAR归档环境，它默认会尝试从文件系统加载资源（支持动态重载），但JAR内的资源是打包在归档里的，没法动态修改，也需要调整加载逻辑：

@Bean
public MessageSourceAccessor messageSource() {
    ReloadableResourceBundleMessageSource aMessageSrc = new ReloadableResourceBundleMessageSource();
    aMessageSrc.setBasename("classpath:messages");
    // 设置UTF-8编码，避免非ASCII字符乱码（如果你的文件有这类字符的话）
    aMessageSrc.setDefaultEncoding("UTF-8");
    // 关闭自动重载，JAR内资源无法动态修改，这个特性没用反而可能出问题
    aMessageSrc.setCacheSeconds(-1);
    // 找不到对应locale的文件时，回退到系统默认locale
    aMessageSrc.setFallbackToSystemLocale(true);
    return new MessageSourceAccessor(aMessageSrc);
}

3. 尝试切换到ResourceBundleMessageSource #

如果上面的配置还是不行，可以试试Spring的另一个消息源实现ResourceBundleMessageSource，它基于Java标准的ResourceBundle，对JAR内资源的支持更稳定：

@Bean
public MessageSourceAccessor messageSource() {
    ResourceBundleMessageSource aMessageSrc = new ResourceBundleMessageSource();
    aMessageSrc.setBasename("messages");
    aMessageSrc.setDefaultEncoding("UTF-8");
    return new MessageSourceAccessor(aMessageSrc);
}

补充：确认JAR内文件位置 #

你解压后看到文件在BOOT-INF/classes下，这是完全正确的——Spring Boot JAR的BOOT-INF/classes就是类路径的根目录，所以classpath:messages的指向是没问题的，只要文件名匹配，配置正确就能读取到。

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