Win10与JDK11环境下Eclipse GWT3.0插件报gwt-module.dtd错误如何解决

报错核心成因 #

• 该报错是版本不匹配触发的XML校验失败：导入的教程示例.gwt.xml配置文件中，DOCTYPE声明默认关联GWT 2.8.1版本的远端DTD资源，和Eclipse GWT 3.0插件内置的3.0版本GWT规则集不兼容，解析时就会抛出单条DTD解析错误。
• 该问题和Windows 10系统、JDK 11的环境配置无关，是教程示例配置和插件版本不匹配导致的，无论导入第三方教程项目还是新建官方示例项目，只要残留旧版DTD声明就会触发相同报错。

分步解决方法 #

• 修改目标.gwt.xml文件的DOCTYPE声明，替换为匹配GWT 3.0版本的本地DTD引用，取消对远端网络资源的依赖：
  1. 定位配置文件中原有的旧DOCTYPE块：

  <!DOCTYPE module PUBLIC "-//Google Inc.//DTD Google Web Toolkit 2.8.1//EN"
    "http://gwtproject.org/doctype/2.8.1/gwt-module.dtd">
  

  2. 替换为和插件内置版本匹配的本地DTD引用：

  <!DOCTYPE module PUBLIC "-//Google Inc.//DTD Google Web Toolkit 3.0//EN"
    "gwt-module.dtd">
  

• 配置Eclipse本地XML校验缓存，避免联网拉取DTD触发校验失败：
  • 打开Eclipse首选项，进入XML > XML Catalog设置页
  • 新增本地映射条目：公共ID填-//Google Inc.//DTD Google Web Toolkit 3.0//EN，关联路径选择GWT插件安装目录下内置的gwt-module.dtd本地文件
• 完成配置后刷新项目，重启Eclipse重新触发类路径校验，原报错即可消除。

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