Jib Gradle插件：模块路径与类路径的选择逻辑及控制方法

默认分配逻辑 #

Jib会根据依赖JAR的结构自动判断路径：

• 包含module-info.class的模块化JAR，会被自动放置到--module-path
• 没有该文件的传统JAR，会被放到--classpath

这个逻辑是Jib遵循Java模块系统规范的默认行为，优先适配模块化应用的运行要求。

显式控制方法 #

如果需要打破默认规则手动指定依赖路径，可以通过Gradle配置实现：

1. 强制将非模块化JAR放到--module-path #

有两种实用方式：

• 生成模块信息：使用Gradle的java-module-info插件给目标依赖生成module-info.class，Jib会自动识别为模块化JAR并归入--module-path。
• 修改Jib容器配置：在Jib配置中直接调整依赖的归属路径：

jib {
  container {
    // 假设customModuleDeps是你定义的包含目标依赖的配置
    modulePath += configurations.customModuleDeps.files
    classpath -= configurations.customModuleDeps.files
  }
}

2. 强制将模块化JAR放到--classpath #

若要把带module-info.class的JAR移到类路径，同样通过Jib配置调整：

jib {
  container {
    // 从默认module-path中移除目标模块化JAR
    modulePath -= configurations.compileClasspath.files.findAll { it.name == 'target-modular.jar' }
    // 将其添加到classpath
    classpath += configurations.compileClasspath.files.findAll { it.name == 'target-modular.jar' }
  }
}

另外，你也可以通过container.jvmFlags直接手动指定完整的--module-path和--classpath参数，完全覆盖Jib的默认配置，但这种方式需要自行维护所有依赖的路径列表，灵活性较低。

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