MissingResourceBundleException 表示 ResourceBundle.getBundle() 未找到任何匹配的 .properties 文件，主因是基础名路径错误、类路径缺失文件、Locale 命名不匹配（如下划线/连字符混淆）、ClassLoader 作用域异常或 IDE 编码设置不当（如未启用 native-to-ascii 转换）。
ResourceBundle.getBundle() 找不到 properties 文件时抛出 MissingResourceBundleException
这个异常本质是 ResourceBundle.getBundle() 在指定路径、基础名、语言环境三者组合下，一个匹配的 .properties 文件都没加载到。不是文件内容错，是压根没定位到文件。
- 检查基础名（baseName）是否对应类路径下的完整包路径，比如
com.example.i18n.Messages对应classpath:/com/example/i18n/Messages.properties - 确保编译后
.properties文件真实存在于 classpath 中（IDE 里看 target/classes 或 build/resources/main 下有无对应路径） - 默认会按
baseName + "_" + language + "_" + country + ".properties"顺序查找，但只要任一环节路径拼错（比如大小写不一致、下划线/连字符混用），就直接跳过，最终 fallback 到baseName + ".properties"—— 这个也不存在就炸 - Maven 项目要确认
src/main/resources已被标记为 Resources Root；Gradle 同理检查resources.srcDirs
Locale 设置与 properties 文件命名不匹配
Java 对 Locale 的解析很严格，zh_CN 和 zh-CN 是两回事，而文件名只认下划线分隔的 zh_CN 形式。
-
new Locale("zh", "CN")会去找Messages_zh_CN.properties，不是Messages_zh-CN.properties - Android 或前端传来的
Accept-Language: zh-CN需手动转换：Locale.forLanguageTag("zh-CN")才能正确映射 - 如果只有
Messages.properties（无后缀），它只作为兜底存在；一旦你传入非默认Locale，JVM 就不会用它，除非显式调用ResourceBundle.getBundle("Messages", Locale.getDefault()) - 注意 JDK 版本差异：JDK 9+ 对空
Locale和ROOT的处理更严格，建议统一用Locale.ROOT表示无区域含义的基准资源
ClassLoader 作用域导致 ResourceBundle 加载失败
默认 ResourceBundle.getBundle() 使用当前线程上下文类加载器（TCCL），但 Web 容器（如 Tomcat）、OSGi 或模块化（JPMS）环境下，TCCL 可能不是你期望的那个。
- 显式传入 ClassLoader：
ResourceBundle.getBundle("Messages", locale, YourClass.class.getClassLoader()) - 避免在静态初始化块中直接调用
getBundle()，此时 TCCL 可能尚未设置或指向 bootstrap 类加载器 - Spring Boot 应用中，如果资源放在
src/main/resources但用了自定义 ClassLoader（如打包成 fat jar 后又解压加载），需确认该 ClassLoader 能访问META-INF/resources或BOOT-INF/classes - 使用
Thread.currentThread().setContextClassLoader()强制切换是临时方案，容易引发泄漏，优先走显式 ClassLoader 参数
IDE 编码问题让 .properties 文件变成乱码甚至不可见
IntelliJ / Eclipse 默认用 UTF-8 读取 .properties，但 Java 规范要求它们必须是 ISO-8859-1 编码（中文需 Unicode 转义），IDE 若未配置好，会导致文件保存时损坏，进而让 ResourceBundle 解析失败并静默跳过。
立即学习“Java免费学习笔记（深入）”；
- 在 IntelliJ 中：File → Settings → Editor → File Encodings → Global Encoding / Project Encoding 设为
UTF-8，同时勾选Transparent native-to-ascii conversion - 检查文件头是否有 BOM：带 BOM 的 UTF-8 会被某些 JVM 拒绝识别，用 hex editor 确认开头不是
EF BB BF - 用
native2ascii工具验证（虽已过时但仍有参考价值）：native2ascii -encoding UTF-8 Messages_zh_CN.properties应输出含\u4f60\u597d的内容 - 现代做法推荐直接用
.properties存 ASCII 键 + JSON/YAML 格式的多语言值，由工具生成转义后的内容，绕过编码陷阱
最常被忽略的是 classpath 路径拼写和 IDE 编码设置这两块——它们不报编译错误，也不打日志，就安静地让 getBundle() 返回 null 或抛 MissingResourceBundleException。调试时先用 ClassLoader.getResource("com/example/i18n/Messages.properties") 打印 URL，比猜强得多。
