Maven依赖库如何通过相对路径访问主项目资源？

数据老陈

2026-7-2

解决模块化Maven库访问主项目资源的问题

核心原因

Java 17的模块化（Jigsaw）机制默认是模块封闭的，你的Maven库作为独立模块，无法直接访问引入它的主项目模块内的资源，除非主项目明确开放资源所在的包权限给你的库模块。

具体解决方案

1. 在主项目的`module-info.java`中开放资源包

找到主项目的module-info.java，添加opens指令，将资源所在的包开放给你的库模块：

// 主项目的module-info.java
module 主项目模块名 {
    // 只开放给你的库模块
    opens me.test to 你的库模块名;
    // 如果需要开放给所有模块，可写：opens me.test;
    
    // 声明对库模块的依赖
    requires 你的库模块名;
}

这里的me.test是资源文件test.xml所在的包路径（对应目录src/main/resources/me/test/）
你的库模块名是你Maven库的module-info.java中定义的模块名称

2. 调整库中资源访问的代码

在库中，你可以继续使用getResource或getResourceAsStream，推荐使用绝对路径以避免包路径混淆：

// 方式1：使用绝对路径（更清晰可靠）
URL resourceUrl = getClass().getResource("/me/test/test.xml");

// 方式2：通过主模块直接获取资源
Optional<Module> mainModule = ModuleLayer.boot().findModule("主项目模块名");
if (mainModule.isPresent()) {
    URL resourceUrl = mainModule.get().getResource("me/test/test.xml");
}