JavaFX+Gradle项目构建报错：找不到twilio模块

问题根源 #

JavaFX模块化项目里，Gradle默认会把非模块化依赖（比如twilio）放到类路径而非模块路径，而module-info.java里声明的requires twilio需要该模块在模块路径上才能被识别。纯Gradle非模块化项目用类路径就能正常运行，但JavaFX项目启用了模块化规则，必须遵循模块路径的要求，这就是报错的核心原因。

修复步骤 #

1. 确认twilio的自动模块名称 #

先检查twilio的JAR包：打开本地Gradle缓存中的twilio-10.1.0.jar（路径一般是~/.gradle/caches/modules-2/files-2.1/com.twilio.sdk/twilio/10.1.0/[哈希值]/twilio-10.1.0.jar），查看META-INF/MANIFEST.MF文件里的Automatic-Module-Name字段。如果没有这个字段，自动模块名就是artifactId的小写形式（这里就是twilio），说明你写的requires twilio;是正确的，排除模块名写错的可能。

2. 调整Gradle配置，强制将twilio加入模块路径 #

在build.gradle中，确保依赖配置正确，同时让Java编译任务把twilio放到模块路径上：

plugins {
    id 'java'
    id 'org.openjfx.javafxplugin' version '0.0.13' // 替换为你实际使用的插件版本
}

javafx {
    version = '21' // 替换为你的JavaFX版本
    modules = ['javafx.controls', 'javafx.fxml'] // 根据项目需求添加其他JavaFX模块
}

dependencies {
    implementation 'com.twilio.sdk:twilio:10.1.0'
}

// 确保编译阶段将twilio纳入模块路径
tasks.withType(JavaCompile) {
    options.compilerArgs += [
        '--module-path', classpath.asPath,
        '--add-modules', 'twilio'
    ]
}

3. 清理缓存并重新构建 #

IDE缓存或旧构建文件可能导致异常，执行以下命令清理后重新构建：

./gradlew clean build

4. 检查module-info.java的位置与内容 #

module-info.java必须放在src/main/java的根目录（不能放在任何子包下），示例内容如下：

module your.project.module.name { // 替换为你的项目模块名
    requires javafx.controls;
    requires javafx.fxml;
    requires twilio;

    // 若使用FXML，需将控制器所在包开放给JavaFX
    opens com.yourproject.controller to javafx.fxml;
    // 导出需要对外访问的包（按需添加）
    exports com.yourproject;
}

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