ModiTect与Jlink无法找到模块依赖问题求助

阿华AIGC实验室

2026-5-22

解决jlink找不到自有模块化JAR的问题

我之前也踩过模块化项目里jlink找不到依赖模块的坑，结合你的情况，咱们一步步排查解决：

1. 先确认自有模块的基础配置是否正确

首先检查你写的tech.flexpoint.dashmancommon模块的module-info.java：

确保模块名称和依赖它的tech.flexpoint.dashmanserver里requires声明的完全一致（大小写、拼写不能有任何差错，Java模块化对名称匹配是严格的）

确认已经导出了dashmanserver需要调用的包，比如：

module tech.flexpoint.dashmancommon {
    exports tech.flexpoint.dashmancommon核心包名;
    // 如果该模块还有其他依赖，也要正确声明requires
}

执行mvn clean install把dashmancommon模块安装到本地Maven仓库，确保dashmanserver能拉到这个已模块化的JAR。

2. 检查ModiTect插件的配置

ModiTect默认处理无module-info的依赖，但对于自有模块化JAR，要确保它被加入到模块路径中：
在dashmanserver的pom.xml里，修改ModiTect的配置，让它能识别到你的自有模块：

<plugin>
    <groupId>org.moditect</groupId>
    <artifactId>moditect-maven-plugin</artifactId>
    <version>你的ModiTect版本</version>
    <executions>
        <!-- 处理第三方依赖的add-module-info目标可以保留 -->
        <execution>
            <id>create-runtime</id>
            <phase>package</phase>
            <goals>
                <goal>create-runtime</goal>
            </goals>
            <configuration>
                <modulePath>
                    <!-- 确保包含本地Maven仓库里的自有模块，或者构建生成的JAR路径 -->
                    <path>${maven.dependency.classpath}</path>
                    <path>${project.build.directory}/modules</path>
                </modulePath>
                <modules>
                    <module>tech.flexpoint.dashmanserver</module>
                </modules>
                <!-- 其他jlink相关配置 -->
            </configuration>
        </execution>
    </executions>
</plugin>

3. 验证jlink命令的模块路径

从报错信息看，jlink的--module-path参数大概率遗漏了tech.flexpoint.dashmancommon的JAR。你可以在执行mvn package时加上-X参数（Maven debug模式），查看完整的jlink命令，确认你的自有模块JAR是否被包含在--module-path里。如果没有，就需要调整ModiTect的create-runtime配置，把该JAR的路径明确加入。