JavaFX+Gradle项目中javax.mail.api模块无法找到的原因

1. 依赖本身的模块化问题 #

早期版本的javax.mail.api可能不是带module-info的模块化JAR包，JVM没法识别成模块，就算你在module-info里声明了requires也没用。

• 建议直接换成Jakarta Mail（javax.mail已经迁移到Jakarta生态，新版本都是模块化的），依赖坐标改成com.sun.mail:jakarta.mail:2.0.1，同时module-info里的声明换成requires jakarta.mail;

2. Gradle依赖配置没到位 #

检查你的build.gradle：

• 确保依赖是加在implementation块里，不是只在测试专用的testImplementation里，比如：

dependencies {
    // 旧版非模块化，不推荐
    // implementation 'com.sun.mail:javax.mail:1.6.2'
    // 新版模块化Jakarta Mail
    implementation 'com.sun.mail:jakarta.mail:2.0.1'
}

• 执行gradle clean build --refresh-dependencies刷新依赖，确保JAR包已经下载到本地仓库。

3. 运行配置的模块路径遗漏 #

IntelliJ的运行配置可能没把javax.mail的JAR加到模块路径里：

• 打开Run/Debug Configurations，找到你的JavaFX运行配置，点Modify options勾选Add VM options
• 检查VM参数里的--module-path，确认javax.mail的JAR已经被包含进去。如果用了JavaFX Gradle插件，一般会自动处理，但手动改配置容易漏。

4. module-info.java声明出错 #

• 核对模块名拼写：旧版javax.mail的模块名是javax.mail.api，Jakarta Mail的模块名是jakarta.mail，别搞混写错。
• 检查有没有大小写或者字符拼写错误，比如少写了.api。

5. JavaFX插件配置冲突 #

如果用了org.openjfx.javafxplugin插件，确保插件版本和JavaFX版本匹配，插件能正确处理第三方依赖的模块路径：

• 参考正确的插件配置：

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

javafx {
    version = '17'
    modules = ['javafx.controls', 'javafx.fxml']
}

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