Java 多个 ModuleLayer 共存时怎么判断模块可读关系

多个 ModuleLayer 同时存在时，判断模块可读关系不要看“是不是父层”“是不是同一个类加载器”，而要拿到运行时的两个 Module 对象，直接检查 source.canRead(target)。findModule 和 findLoader 只能帮你定位对象与装载器，不能替代 canRead。

先分清层、模块和类加载器三件事

一个层由配置和“模块名到类加载器”的映射创建。当前层的 modules() 只返回本层模块；parents() 返回父层，而且父层有搜索顺序。相反，findModule("x") 会先看当前层，再沿父层查找。因此，能找到一个模块，只能说明它在可搜索的层树里存在。

类加载器也有类似的混淆风险。findLoader("x") 返回模块对应的加载器；使用 defineModulesWithManyLoaders 时，每个模块有自己的加载器，使用 defineModulesWithOneLoader 时，多个模块可能共享一个加载器。两者都不直接回答 reads 关系。

先把运行时对象和观察字段打出来

排查多个层时，先固定一个模块名，再同时记录它来自哪个层、由哪个加载器定义。下面的辅助方法不创建模块，也不改变可读关系，只负责把定位信息打印出来：

static void printModule(ModuleLayer layer, String name) {
    // findModule 会沿当前层和父层搜索，找不到时返回空 Optional。
    Module module = layer.findModule(name)
            .orElseThrow(() -> new IllegalArgumentException("模块不存在: " + name));

    // getLayer 对命名模块通常能返回所属层；这里把层和加载器一起记录。
    ClassLoader loader = module.getClassLoader();
    System.out.printf("module=%s layer=%s loader=%s%n",
            module.getName(), module.getLayer(), loader);
}

这里的关键是不要只打印 module.getName()。同一进程里可以存在来自不同层的模块对象；把 getLayer() 和 getClassLoader() 一起留下，后面才能解释“找到的是哪一个实例”。

用 Module.canRead 判断方向

真正的判断可以写成一个可读矩阵。假设 app 是调用方，plugin.api 是目标模块：

static void printReadability(Module app, Module pluginApi) {
    // canRead(a, b) 只回答 a 是否读取 b，参数顺序不能交换。
    boolean appReadsPlugin = app.canRead(pluginApi);
    boolean pluginReadsApp = pluginApi.canRead(app);

    System.out.printf("%s -> %s: %s%n",
            app.getName(), pluginApi.getName(), appReadsPlugin);
    System.out.printf("%s -> %s: %s%n",
            pluginApi.getName(), app.getName(), pluginReadsApp);
}

如果第一行是 true、第二行是 false，这是正常的单向关系，不是数据异常。模块能否访问某个包还要再看目标包是否 exports；反射是否能深入访问则涉及 opens，不能用 canRead 一项包办。

多层共存时的处理边界

创建新层时，配置的父层必须和传入的父层匹配；否则层创建本身就会失败。层创建成功后，findModule 仍可能因为父层搜索顺序拿到另一个同名模块，所以建议保留 Module 对象本身，不要只缓存字符串名称。

如果确实是运行时插件协议要求某个模块新增读取关系，应由有权限的调用方使用 source.addReads(target)，并把这项变更当成显式的模块图调整。它不能解决目标包未导出、包未打开或类由另一套加载器定义的问题。更稳妥的记录至少包括下面四列：

延伸问答

父层里的模块，子层一定能读取吗？

不应这样推断。父层影响配置解析和查找路径，最终仍应对具体的运行时模块调用 canRead。

两个模块使用同一个 ClassLoader 就可读吗？

不一定。类加载器映射解决“由谁定义和加载”，reads 图解决“模块是否读取”，两者是不同维度。

canRead 为 false 时直接调用 addReads 可以吗？

只有模块系统允许的调用者才能动态增加读取关系，而且新增 reads 也不会自动导出或打开目标包。应先确认模块设计和调用权限。

参考资料：Java SE 25 ModuleLayer API、Java SE 25 Module API。