升级maven-plugin-plugin至3.6.4触发qdox语法解析异常

问题分析 #

升级maven-plugin-plugin至3.6.4版本后，执行descriptor目标时触发Qdox解析报错，但代码可正常编译。核心原因是：该版本插件依赖的Qdox库（用于解析Java源码生成插件描述符）对部分Java语法的支持度，低于项目使用的Java编译器版本，导致编译器能处理的语法Qdox无法解析。

解决方案 #

• 定位并修正语法问题：打开报错的Foo.java文件，查看第60行第84列的代码，确认是否使用了Qdox不支持的语法（比如Java 11+的文本块、特定场景下的var、密封类等）。如果是，可调整为兼容的写法。
• 升级maven-plugin-plugin版本：将插件版本升级至3.7.0及以上，这些版本更新了依赖的Qdox库，对高版本Java语法支持更完善。示例配置：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-plugin-plugin</artifactId>
    <version>3.7.2</version> <!-- 或更高稳定版 -->
  </plugin>
  

• 强制更新Qdox依赖：若不想升级插件版本，可在插件配置中指定更高版本的Qdox，覆盖默认依赖：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-plugin-plugin</artifactId>
    <version>3.6.4</version>
    <dependencies>
      <dependency>
        <groupId>com.thoughtworks.qdox</groupId>
        <artifactId>qdox</artifactId>
        <version>2.0.2</version> <!-- 选择兼容的高版本 -->
      </dependency>
    </dependencies>
  </plugin>
  

• 临时回退插件版本：若上述方案均无法快速解决，可暂时回退至3.6.0版本，待问题排查完成后再升级。

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