JDK 21 + Eclipse 2024-03环境下无法找到org.w3c.dom类求助

问题描述 #

用Ant构建Jar文件完全正常，但使用相同类路径的Eclipse却提示无法解析org.w3c.dom.Document；若将相关源文件放入src目录，又会提示org.w3c.dom已存在于java.xml中。报错信息如下：

The project was not built since its build 
path is incomplete. Cannot find the class 
file for org.w3c.dom.Document. Fix the build 
path then try building this project
The type org.w3c.dom.Document cannot be 
resolved. It is indirectly referenced from required type 
org.apache.xerces.parsers.AbstractDOMParser

已尝试关闭并重新打开项目，问题仍未解决。

解决方案 #

• 检查JRE系统库完整性
  右键项目 → Build Path → Configure Build Path → 切换到Libraries标签页，找到JRE System Library：
  • 确认使用的是完整的JDK/JRE，而非精简版（部分精简JRE会移除XML相关核心类）；
  • 若当前用的是自定义JRE，尝试切换为Eclipse自带的JDK/JRE版本。
• 移除冲突的Xerces依赖
  报错中提到org.apache.xerces.parsers.AbstractDOMParser，而JDK自带了XML解析实现，手动添加的Xerces jar包会和JDK核心库冲突：
  去Libraries标签页中找到Xerces相关jar文件，直接移除即可。Ant能正常构建是因为类加载机制和Eclipse不同，不会触发这类冲突。
• 彻底清理项目缓存
  点击菜单栏Project → Clean，选择当前项目执行清理，之后重新构建项目。这比单纯重启项目更能解决缓存损坏导致的类路径异常。
• 调整类路径加载顺序
  进入Build Path的Order and Export标签页，将JRE System Library移到所有第三方jar包的上方。确保Eclipse优先加载JDK核心类，避免第三方库的类覆盖核心类。
• 禁止手动添加org.w3c.dom源文件
  org.w3c.dom属于JDK核心库的一部分，手动将其源文件放入src目录必然导致类重复冲突，直接删除src中的相关文件即可。

内容的提问来源于stack exchange，提问作者Wayne B.