SpringBoot中MessageSource在工具类调用时报NoSuchMessageException，但配置类内可正常读取消息

这个问题我之前也碰到过，结合你的代码细节来看，大概率是几个容易忽略的细节导致的，咱们一步步排查解决：

1. 缓存时间参数的类型不匹配（最常见原因） #

你在配置类里用setCacheMillis(cacheInSeconds)，但setCacheMillis接收的是毫秒类型，而你的cacheInSeconds是秒数！比如如果配置的缓存时间是3600秒，实际设置的缓存时间只有3.6秒，缓存过期后MessageSource会重新加载资源，如果此时加载失败（比如文件权限、路径问题），就会抛出找不到消息的异常。而配置类里的调用是在bean初始化时同步加载的，所以能成功。

解决方式：
把秒数转换成毫秒，同时给缓存时间设置默认值，避免配置缺失导致null：

@Value("${response-message.cache:3600}") // 默认缓存1小时
Integer cacheInSeconds;

// ...

// 转换为毫秒设置缓存
messageSource.setCacheMillis(cacheInSeconds * 1000L);

2. 外部文件路径缺少file:前缀 #

如果你的messageFilePath是外部文件系统路径（比如/config/messages），必须给路径加上file:前缀，否则ReloadableResourceBundleMessageSource会默认从classpath下查找文件，初始化时可能因为某些临时路径能找到，但后续重新加载时就找不到了。

解决方式：
在设置basename时自动补全前缀：

String basename = messageFilePath.startsWith("file:") ? messageFilePath : "file:" + messageFilePath;
messageSource.setBasename(basename);

3. 静态工具类的初始化与MessageSource加载时机问题 #

虽然你用了@PostConstruct初始化静态instance，但如果在Spring上下文完全初始化完成前就调用getMessage()，可能会出现MessageSource资源未完全加载的情况。另外，可以优化工具类的异常处理，方便排查问题。

优化后的工具类代码：

@Slf4j
@Component
public class ResponseMessageUtil {

    @Autowired
    private MessageSource messageSource;
    private static ResponseMessageUtil instance;

    @PostConstruct
    private void init() {
        instance = this;
        log.info("ResponseMessageUtil初始化完成，绑定的MessageSource实例：{}", messageSource);
    }

    public static String getMessage(String status, Object[] args) {
        if (instance == null) {
            throw new IllegalStateException("ResponseMessageUtil还未初始化，请确保Spring上下文加载完成后再调用");
        }
        String code = String.format("%s.%s", status, "code");
        try {
            String msg = instance.messageSource.getMessage(code, args, Locale.ENGLISH);
            log.info("成功获取消息，code：{}，内容：{}", code, msg);
            return msg;
        } catch (NoSuchMessageException e) {
            log.error("获取消息失败，code：{}", code, e);
            throw e;
        }
    }
}

4. 确保自定义MessageSource的唯一性 #

SpringBoot默认会提供一个MessageSource bean，为了确保咱们自定义的bean被优先注入，可以明确指定bean名称为messageSource（虽然默认方法名就是这个，但明确指定更保险）：

@Bean(name = "messageSource")
public MessageSource messageSource() {
    // ... 原有代码
}

额外排查点 #

• 检查配置文件中的response-message.path是否正确，目标文件是否存在、应用是否有读取权限；
• 确认消息配置文件中确实存在0400-0001.code这个键，注意大小写和拼写；
• 在配置类和工具类中分别打印MessageSource的hashCode，确认是同一个实例，避免注入错误的bean。

修改后的完整配置类示例：

@Configuration
@Slf4j
public class ResponseMessageConfig {

    @Value("${response-message.path:classpath:messages}")
    String messageFilePath;

    @Value("${response-message.cache:3600}")
    Integer cacheInSeconds;

    @Bean(name = "messageSource")
    public MessageSource messageSource() {
        ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();

        // 处理外部文件路径前缀
        String basename = messageFilePath.startsWith("file:") ? messageFilePath : "file:" + messageFilePath;
        messageSource.setBasename(basename);

        messageSource.setDefaultEncoding("UTF-8");
        messageSource.setCacheMillis(cacheInSeconds * 1000L);
        
        // 强制初始化资源，避免懒加载导致的问题
        messageSource.afterPropertiesSet();

        // 测试加载
        String msg = messageSource.getMessage(String.format("%s.%s", "0400-0001", "code"), null, Locale.ENGLISH);
        log.info("初始化时成功加载消息：{}", msg);

        return messageSource;
    }
}

备注：内容来源于stack exchange，提问作者Harish R