Java多模块项目ResourceBundle跨模块加载异常排查求助

问题场景 #

项目包含3个模块：

• generic：作为Romania和Cyprus模块的基础依赖
• Romania：业务模块
• Cyprus：业务模块
  三个模块的resources/language目录下均存在first_en_US_CUSTOM资源包。

运行Romania模块时，调用JAR中的getTranslated方法（代码如下），返回的却是Cyprus模块的字符串；删除Cyprus模块的对应资源包后，又会加载generic模块的资源包，而非Romania自身的资源包。

private String getTranslated(ResourceBundle resourceBundle) { // resource bundle comes with locale en_US
    String result = null;
    try {
        String text = resourceBundle.getString(key);
        result = text;
    } catch (MissingResourceException var7) {
        System.out.println("No resource found");
    }
    return result;
}

问题根源 #

核心原因是ResourceBundle的类加载器资源查找顺序不符合预期。Java中ResourceBundle加载资源时，依赖类加载器的资源查找机制：当多个模块存在同名资源包时，类加载器会返回它遍历到的第一个匹配资源，而非当前业务模块的资源。

具体表现为：

• 运行Romania模块时，类加载器先找到了Cyprus模块下的first_en_US_CUSTOM资源包，因此返回Cyprus的字符串；
• 删除Cyprus的资源包后，类加载器又先匹配到generic模块的同名资源包，于是返回generic的内容。

排查方向 #

• 检查类加载器的查找优先级：确认Romania模块的类加载器是否优先加载自身模块内的资源，还是遵循父类加载器优先的规则（导致先加载generic或Cyprus的资源）。
• 验证资源包的路径与命名：确保三个模块的资源包路径完全一致，first_en_US_CUSTOM的命名符合ResourceBundle规范（比如后缀是否为.properties，无拼写错误）。
• 核对模块依赖与打包顺序：确认Romania模块的资源是否被正确打包到JAR中，且构建工具（Maven/Gradle）的依赖顺序没有让Cyprus或generic的资源优先进入类路径。
• 排查ResourceBundle的初始化逻辑：确认传入getTranslated方法的resourceBundle实例是通过哪个类加载器创建的——如果是用ResourceBundle.getBundle()方法初始化，要确认调用该方法的类属于哪个模块（类加载器与调用类绑定）。
• 查看运行时类路径：打印当前运行环境的类路径，确认三个模块的资源包在类路径中的排列顺序，是否Cyprus或generic的资源包排在Romania之前。

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