IntelliJ IDEA中JavaFX项目启动报错：找不到html2pdf模块

1. 先确认Gradle依赖配置正确 #

检查你的build.gradle里的html2pdf依赖是否格式正确，正确配置示例：

dependencies {
    // 替换成最新稳定版本号，比如5.0.1
    implementation 'com.itextpdf:html2pdf:5.0.1'
}

写完后点击IntelliJ右侧Gradle面板的刷新图标，确保依赖成功下载到本地仓库。如果下载失败，检查网络或切换Gradle镜像源。

2. 处理模块系统不兼容问题 #

html2pdf大概率不是模块化JAR（没有自带module-info.java），直接在module-info.java里声明requires html2pdf会导致JVM找不到合法模块，两种解决方式：

方法A：给Gradle运行任务添加模块参数 #

修改build.gradle的run任务，手动将html2pdf纳入模块路径：

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

// ... 其他配置（JavaFX模块、mainClass等） ...

run {
    jvmArgs = [
        // 自动模块名一般是依赖的artifactId，这里为html2pdf
        '--add-modules', 'html2pdf',
        // 允许你的主模块访问html2pdf模块
        '--add-reads', 'org.main.culturesolutioncalculation=html2pdf'
    ]
}

如果自动模块名不正确，可去本地仓库找到下载的html2pdf JAR包，去掉版本号的文件名就是自动模块名（比如html2pdf-5.0.1.jar对应模块名html2pdf）。

方法B：改用非模块化运行（新手友好） #

如果暂时不想纠结模块系统，直接删除项目中的module-info.java，然后修改build.gradle为非模块化配置：

dependencies {
    implementation 'com.itextpdf:html2pdf:5.0.1'
    // 替换为你的JavaFX版本和所需模块
    implementation 'org.openjfx:javafx-controls:21.0.2'
    implementation 'org.openjfx:javafx-fxml:21.0.2'
}

run {
    mainClass = 'org.main.culturesolutioncalculation.Main'
}

这种方式用传统类路径运行，无需模块配置，新手更容易操作。

3. 检查IntelliJ运行配置 #

确保使用Gradle自动生成的运行配置，而非手动创建的。如果是手动配置，在Run/Debug Configurations中，选择Use classpath of module为你的主模块，并确认html2pdf的JAR已在classpath列表中。

4. 清理缓存重新同步 #

若以上方法无效，尝试删除Gradle缓存：

• Windows路径：C:\Users\<你的用户名>\.gradle\caches
• Mac/Linux路径：~/.gradle/caches
• 删除缓存目录后，回到IntelliJ点击Gradle刷新按钮，重新下载依赖

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