如何在Java 11+应用中使用无module-info的Java 8库（Gradle/IntelliJ配置）

核心原因 #

你用到的Java 8构建JAR没有module-info.class，属于自动模块；但你的主应用因依赖JavaFX这类模块化库，运行时会启用模块系统。如果配置不当，模块系统无法正确识别这些自动模块，就会抛出Module ... not found错误。直接混放--class-path和--module-path会导致模块系统无法解析自动模块。

Gradle配置方案 #

1. 标记Java 8 JAR为自动模块 #

在构建脚本中，将无module-info的JAR配置为自动模块，确保它们被加入模块路径而非普通类路径，同时显式声明模块依赖。

Groovy DSL示例

plugins {
    id 'application'
    id 'org.openjfx.javafxplugin' version '0.0.13'
}

javafx {
    version = '17' // 替换为你使用的JavaFX版本
    modules = ['javafx.controls', 'javafx.fxml'] // 根据需求调整模块
}

dependencies {
    // 本地JAR依赖示例
    implementation files('libs/foo.jar', 'libs/bar.jar')
    // 仓库依赖示例：implementation 'com.example:legacy-lib:1.0'
}

// 配置运行时参数
tasks.withType(JavaExec) {
    jvmArgs = [
        '--module-path', classpath.asPath,
        '--module', '你的主模块名/主类全名', // 例如：com.myapp/com.myapp.Main
        '--add-modules', 'foo,bar' // 替换为自动模块的实际名称
    ]
    // 不要同时设置--class-path，模块化应用优先使用module-path
}

// 配置编译时参数
compileJava {
    options.compilerArgs += [
        '--module-path', classpath.asPath,
        '--add-modules', 'foo,bar'
    ]
}

Kotlin DSL示例

plugins {
    application
    id("org.openjfx.javafxplugin") version "0.0.13"
}

javafx {
    version = "17"
    modules = listOf("javafx.controls", "javafx.fxml")
}

dependencies {
    implementation(files("libs/foo.jar", "libs/bar.jar"))
    // implementation("com.example:legacy-lib:1.0")
}

tasks.withType<JavaExec> {
    jvmArgs = listOf(
        "--module-path", classpath.asPath,
        "--module", "你的主模块名/主类全名",
        "--add-modules", "foo,bar"
    )
}

tasks.withType<JavaCompile> {
    options.compilerArgs.addAll(listOf(
        "--module-path", classpath.asPath,
        "--add-modules", "foo,bar"
    ))
}

2. 确认自动模块名称 #

如果不确定自动模块的名称，可通过以下命令查询：

jar --file=你的JAR文件名.jar --describe-module

若输出无明确模块名，系统会自动推导：去掉JAR文件名的版本号，将下划线替换为点，例如foo-core-2.3.jar的自动模块名为foo.core。

IntelliJ IDEA配置 #

1. 模块依赖设置 #

• 打开File > Project Structure > Modules
• 选中主模块，切换到Dependencies标签页
• 找到Java 8的JAR依赖，将其Scope设为Compile，并确保放在Modulepath下（而非Classpath）
• 若未自动识别为模块，点击依赖项旁的Edit，选择Module Library

2. 运行配置调整 #

• 打开Run > Edit Configurations
• 选中应用的运行配置，切换到VM options
• 输入类似Gradle的JVM参数：

  --module-path $MODULE_PATH$ --module 你的主模块名/主类全名 --add-modules foo,bar
  

• 确保Use classpath of module选择你的主模块

关键注意事项 #

• 不要同时用--class-path和--module-path加载无module-info的JAR，模块化应用中模块路径优先，类路径的JAR不会被模块系统识别为自动模块
• 主应用的module-info.java需正确声明对自动模块的依赖，示例：

  module com.myapp {
      requires foo;
      requires bar;
      requires javafx.controls;
      exports com.myapp;
  }
  

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