MissingResourceException是ResourceBundle加载资源包失败时抛出的运行时非受检异常，根本原因是资源文件缺失、路径/命名错误、类路径未包含资源目录或locale不匹配；必须确保messages.properties等基础文件置于classpath根路径、命名规范（如messages_zh_CN.properties）、调用时不带扩展名或路径，并通过ClassLoader.getSystemResource验证定位。
MissingResourceException 是运行时异常，属于非受检异常（unchecked exception），Java 编译器不要求强制捕获或声明。它发生在 ResourceBundle 无法定位整个资源包（如 messages_zh_CN.properties）时，而非某个 key 缺失——这意味着问题出在“文件级”而非“键级”，程序连语言包都加载不进来，根本还没走到取值逻辑。
资源文件必须存在且路径正确
ResourceBundle 按 basename + "_" + language + "_" + country + ".properties" 层级查找，最终回退到基础名（如 messages.properties）。若连基础文件都不存在，任何 locale 都会直接抛 MissingResourceException。确保：
- 所有 .properties 文件放在
src/main/resources（Maven/Gradle 默认资源根目录）下，编译后位于 classpath 根路径 - 文件名严格匹配：大小写敏感、无空格、下划线分隔（
messages_zh_CN.properties✅，messages_zh-CN.properties❌） - 基础文件
messages.properties必须存在，它是 fallback 的最后保障
加载时不能带路径或扩展名
调用 ResourceBundle.getBundle("messages") 即可，不要写成 "messages.properties" 或 "i18n/messages"。后者会导致类加载器按包路径查找，而实际文件在 classpath 根目录，必然失败。
验证是否能被定位：可在启动时加一行测试
立即学习“Java免费学习笔记（深入）”；
ClassLoader.getSystemResource("messages.properties")返回 null 说明资源未进 classpath，需检查构建配置或 IDE 资源设置。
Spring Boot 中无法用 @ExceptionHandler 捕获
该异常发生在容器启动阶段（MessageSource 初始化时），远早于请求处理流程，因此 @ControllerAdvice 和全局异常处理器完全无效。降级必须靠配置实现：
- 设
spring.messages.basename=messages，确保指向一个始终存在的基础文件 - 禁用系统 locale 回退：
spring.messages.fallback-to-system-locale=false - 开启 key 回退机制：
spring.messages.use-code-as-default-message=true（应对 key 缺失，虽不解决 MissingResourceException，但避免后续 NoSuchMessageException）
增强健壮性的启动校验
非受检异常虽不用 try-catch，但生产环境应主动防御：
- 应用启动后立即尝试加载关键 locale（如
new Locale("zh", "CN")），捕获 MissingResourceException 并记录告警日志 - 使用 IDE 的 ResourceBundle 插件自动检查多语言文件完整性（如缺失基础文件、命名不规范等）
- Maven 项目确认
maven-resources-plugin已启用，默认会把 resources 目录复制进 target/classes
