如何在Gradle中排除jOpenDocument的org.w3c.dom依赖解决包冲突

冲突本质分析 #

你遇到的错误是Java模块系统的核心限制：同一个包不能被多个模块导出/读取。jOpenDocument的jar包中直接内置了org.w3c.dom包的类，而Java核心库的java.xml模块也导出了这个包，导致模块系统无法确定使用哪个版本的包，从而抛出冲突错误。

你之前用exclude group: 'org.w3c.dom'无效，是因为这个包不是jOpenDocument的传递依赖，而是它自身jar包自带的内容，exclude仅能排除传递依赖，无法移除jar内部的包。

可行解决方案 #

方案1：通过JVM参数强制模块依赖优先级 #

jOpenDocument是未模块化的jar，会被Java模块系统识别为自动模块，可以通过添加JVM参数让它优先使用java.xml提供的org.w3c.dom包：

1. 在Gradle的application配置中添加JVM参数：

application {
    mainModule = "Pervap3" 
    mainClass = "application.Main"
    applicationDefaultJvmArgs = [
        "--add-exports", "java.xml/org.w3c.dom=ALL-MODULES",
        "--add-reads", "jOpenDocument=java.xml"
    ]
}

如果使用jlink打包，需要同步把参数配置到jlink选项中：

jlink {
    options = ['--add-exports', 'java.xml/org.w3c.dom=ALL-MODULES', '--add-reads', 'jOpenDocument=java.xml']
}

方案2：重新打包jOpenDocument，移除内置的org.w3c.dom包 #

这是更彻底的解决方式，直接修改jOpenDocument的jar包，删除其中的org.w3c.dom相关类：

1. 在Gradle中添加自定义任务完成修复：

task fixJOpenDocument(type: Jar) {
    // 解压原jOpenDocument jar包
    from zipTree(configurations.runtimeClasspath.find { it.name.startsWith('jOpenDocument') })
    // 排除内置的org.w3c.dom包
    exclude 'org/w3c/dom/**'
    // 输出修复后的jar文件名
    archiveFileName = 'jOpenDocument-fixed.jar'
    destinationDirectory = file("$buildDir/libs/fixed")
}

// 让编译任务依赖修复任务
compileJava.dependsOn fixJOpenDocument

// 修改依赖，使用修复后的本地jar
dependencies {
    // 注释掉原jOpenDocument依赖
    // implementation 'org.jopendocument:jOpenDocument:1.3'
    // 依赖修复后的jar
    implementation files("$buildDir/libs/fixed/jOpenDocument-fixed.jar")
}

执行./gradlew fixJOpenDocument生成修复后的jar，再同步Gradle即可。

Eclipse中"Type not accessible"错误解决 #

这个错误通常是Eclipse模块路径配置与Gradle不一致导致的：

• 确保module-info.java中正确声明对jOpenDocument的依赖：

module Pervap3 {
    requires javafx.controls;
    requires javafx.fxml;
    requires jakarta.json;
    requires org.xerial.sqlitejdbc;
    // 自动模块名由jar文件名推断，这里是jOpenDocument
    requires jOpenDocument;
}

• 右键项目 → Build Path → Configure Build Path → Module Path，检查jOpenDocument是否被添加到模块路径（而非类路径）中。
• 执行./gradlew eclipse重新生成Eclipse配置文件，再刷新项目。

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