IntelliJ中无法为Gradle项目添加Maven库（iText7-core）

你的项目是JPMS模块化项目，这是导致依赖无法生效的核心原因——普通的依赖配置不足以让模块化系统识别iText7的模块，需按以下步骤操作：

1. 正确配置Gradle依赖 #

在build.gradle的dependencies块中添加iText7核心依赖：

dependencies {
    implementation('org.controlsfx:controlsfx:11.1.2')
    // 新增iText7核心依赖
    implementation 'com.itextpdf:itext7-core:7.0.4'

    testImplementation("org.junit.jupiter:junit-jupiter-api:${junitVersion}")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:${junitVersion}")
}

添加完成后，点击IntelliJ右上角的Gradle刷新按钮（大象图标），等待依赖下载完成。

2. 配置模块声明（必须步骤） #

打开项目根目录下的src/main/java/module-info.java，添加对iText7子模块的依赖声明：

module com.preventivoapp.appproject_preventivo {
    requires javafx.controls;
    requires javafx.fxml;
    requires org.controlsfx.controls;
    // 引入iText7的核心子模块
    requires com.itextpdf.kernel;
    requires com.itextpdf.io;
    requires com.itextpdf.layout;
    // 若需使用其他功能（如HTML转PDF），可额外添加：
    // requires com.itextpdf.styledxmlparser;

    opens com.preventivoapp.appproject_preventivo to javafx.fxml;
    exports com.preventivoapp.appproject_preventivo;
}

说明：iText7-core是聚合模块，实际包含多个独立的JPMS子模块，模块化项目必须直接依赖这些子模块才能正常使用。

3. 验证与故障排除 #

• 尝试在代码中导入iText类，比如：

  import com.itextpdf.kernel.pdf.PdfDocument;
  import com.itextpdf.kernel.pdf.PdfWriter;
  

• 若仍报错，执行以下操作：
  • 运行Gradle的clean和build任务：在IntelliJ的Gradle面板中，依次执行Tasks > build > clean和build。
  • 清理IntelliJ缓存：File > Invalidate Caches...，勾选"Clear file system cache and local history"后点击Invalidate and Restart。

关于手动导入lib文件夹无效的原因 #

模块化项目中，依赖jar包需放置在module-path而非传统的class-path，直接将jar包放入lib文件夹，Gradle不会自动将其加入模块路径，因此无法被模块化系统识别。

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