Java 8迁移Java 11遇org.w3c.dom多模块包冲突，求解决方案

你遇到的这个"The package org.w3c.dom is accessible from more than one module"错误，本质是Java 9+模块系统带来的包冲突问题——JDK自带的java.xml模块已经包含了org.w3c.dom、javax.xml.parsers这些核心XML处理包，而你项目中依赖的xml-apis等第三方库也提供了完全相同的包，导致编译时模块路径冲突。下面给你几个实操性强的解决方案：

方案1：统一处理依赖，将冲突包标记为provided #

最根治的方法是让Maven知道这些XML相关的包已经由JDK提供，无需引入第三方依赖。你可以在dependencyManagement中统一配置，避免逐个依赖手动排除：

<dependencyManagement>
  <dependencies>
    <!-- 统一声明xml-apis由JDK提供，覆盖所有传递依赖 -->
    <dependency>
      <groupId>xml-apis</groupId>
      <artifactId>xml-apis</artifactId>
      <version>1.4.01</version> <!-- 替换成你项目中实际的版本 -->
      <scope>provided</scope>
    </dependency>
    <!-- 如果还有其他类似冲突包（如xmlParserAPIs），同样配置 -->
    <dependency>
      <groupId>xerces</groupId>
      <artifactId>xmlParserAPIs</artifactId>
      <version>2.6.2</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

配置后，Maven编译时会优先使用JDK自带的类，同时不会因为移除第三方依赖导致编译报错。如果想确认哪些依赖引入了冲突包，可以执行命令：

mvn dependency:tree -Dincludes=xml-apis

这样能精准定位所有传递依赖中的xml-apis，确保没有遗漏。

方案2：通过编译器参数临时绕过冲突（过渡用） #

如果暂时无法彻底清理依赖，可以通过maven-compiler-plugin添加编译参数，允许未命名模块访问JDK模块中的包：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.8.1</version> <!-- 使用适配Java 11的版本 -->
  <configuration>
    <release>11</release>
    <compilerArgs>
      <arg>--add-exports=java.xml/org.w3c.dom=ALL-UNNAMED</arg>
      <arg>--add-exports=java.xml/javax.xml.parsers=ALL-UNNAMED</arg>
      <!-- 其他冲突包同理添加 -->
    </compilerArgs>
  </configuration>
</plugin>

这个方案属于“绕过问题”，适合短期过渡，长期来看还是建议清理依赖，避免后续维护隐患。

方案3：调整框架代码，移除对第三方XML包的依赖 #

如果你们的自研框架中有直接依赖xml-apis的代码，可以尝试替换为JDK原生API。比如：

• 原来导入org.w3c.dom.Attr时，直接使用JDK自带的即可，无需依赖第三方库；
• javax.xml.parsers.DocumentBuilder这类类在Java 11中已经完全支持，移除xml-apis依赖后不会影响功能。
  毕竟xml-apis最初是为了兼容老版本JDK而存在的，升级到Java 11后完全可以抛弃。

额外注意：同步Eclipse配置 #

确保Eclipse的构建配置和Maven一致：

• 在项目属性的Java Build Path中，找到xml-apis等冲突依赖，右键选择Exclude；
• 确认Java Compiler中的Release版本设置为11，和Maven配置对齐。

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