Java 21升级遇到Maven PMD插件兼容性问题？详解解决方案

2024-03-14 20:31:25

Java 21升级：Maven PMD插件兼容性指南

问题

随着应用程序升级到Java 21，开发人员遇到了Maven PMD插件版本3.19.0与Java 21不兼容的问题。

症状

在执行“mvn clean install”命令时，会收到错误消息：

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-pmd-plugin:3.19.0:pmd (pmd) on project domain: Execution pmd of goal org.apache.maven.plugins:maven-pmd-plugin:3.19.0:pmd failed: org.apache.maven.reporting.MavenReportException: Unsupported targetJdk value '21'.

原因

根据Maven PMD插件文档，受支持的Java版本仅限于Java 20。Java 21兼容性尚未明确列出。

解决方案

1. 升级PMD插件

检查Maven中央存储库是否有更新的PMD插件版本。升级到兼容Java 21的最新版本。

2. 降级Java版本

暂时降级到较低版本的Java（如Java 20），直至PMD插件升级或提供其他解决方案。

3. 禁用PMD插件

在pom.xml中注释掉或删除PMD插件配置，以暂时禁用它。但这将禁用PMD检查，可能会降低代码质量。

4. 使用替代工具

探索替代的PMD工具，如Checkstyle或FindBugs，它们可能与Java 21兼容。

5. 等待官方更新

等待PMD插件的官方更新，其中可能包含对Java 21的支持。

更新pom.xml配置

升级PMD插件时，需要修改pom.xml配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-pmd-plugin</artifactId>
    <version>3.20.0</version>
    <executions>
        <execution>
            <id>pmd</id>
            <phase>verify</phase>
            <goals>
                <goal>pmd</goal>
            </goals>
        </execution>
        <!-- 其他执行 -->
    </executions>
    <configuration>
        <targetJdk>21</targetJdk>
        <!-- 其他配置 -->
    </configuration>
</plugin>