将 Maven 插件升级到 Java 11

Posted

技术标签:

【中文标题】将 Maven 插件升级到 Java 11【英文标题】:Upgrading Maven plugins to Java 11 【发布时间】:2021-11-12 18:03:02 【问题描述】:

我正在将我的 Maven 构建的 Java 8 应用升级到 Java 11。在我的 POM 中我指定:

<properties>
  <java.version>1.11</java.version>
  <maven.compiler.source>$java.version</maven.compiler.source>
  <maven.compiler.target>$java.version</maven.compiler.target>
</properties>

当我使用正常的 Maven 构建调用构建我的应用程序时:

mvn verify -Plocal -Dspring-boot.run.jvmArguments="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005"

我明白了:

[INFO] Scanning for projects...
[INFO] 
[INFO] -----------------------< example.com:myapp-svc >------------------------
[INFO] Building myapp-svc 1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-checkstyle-plugin:3.1.2:check (validate) @ myapp-svc ---
[WARNING] Old version of checkstyle detected. Consider updating to >= v8.30
[WARNING] For more information see: https://maven.apache.org/plugins/maven-checkstyle-plugin/examples/upgrading-checkstyle.html
[INFO] Starting audit...
Audit done.
[INFO] You have 0 Checkstyle violations.
[INFO] 
[INFO] --- jacoco-maven-plugin:0.8.7:prepare-agent (default) @ myapp-svc ---
[INFO] argLine set to -javaagent:/Users/myuser/.m2/repository/org/jacoco/org.jacoco.agent/0.8.7/org.jacoco.agent-0.8.7-runtime.jar=destfile=/Users/myuser/workspace/myapp-svc/target/jacoco.exec
[INFO] 
[INFO] --- maven-resources-plugin:3.1.0:resources (default-resources) @ myapp-svc ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 6 resources
[INFO] Copying 154 resources
[INFO] 
[INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ myapp-svc ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 456 source files to /Users/myuser/workspace/myapp-svc/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.076 s
[INFO] Finished at: 2021-11-12T12:52:52-05:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile (default-compile) on project myapp-svc: Fatal error compiling: error: invalid target release: 1.11 -> [Help 1]
[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException

所以看起来maven-compiler-plugin:3.8.1 插件与Java 11 不兼容。问题是,我没有直接在我的POM 中的任何地方指定该插件。因此,某处正在拉动它并使用它,我的猜测是我必须更新 那个 的东西,以便它引入 是的maven-compiler-plugin 版本 em> 与 Java 11 兼容。

那么我怎么知道是什么在拉动它并使用它呢?或者,如果这不是正在发生的事情,那是什么以及如何解决?

【问题讨论】:

去掉“1”。从Java版本。改为:&lt;java.version&gt;11&lt;/java.version&gt; 哦,哇,谢谢@BasilBourque (+1)。这行得通,但是我很好奇,以前那个值是&lt;java.version&gt;1.8&lt;/java.version&gt;。那么为什么 不会 是 Java 11 的 1.11 呢?同样本着“授人以渔”的精神,您怎么知道正确的值是“11”而不是“1.11”?再次感谢! 您可能会在 Java JEP 中找到记录和解释的 Java 版本编号更改。 请发布并接受对您问题的回答,准确说明您为解决问题所做的工作。并链接到那个 JEP,如果你找到的话。 因为您很感兴趣,所以您应该像我建议的那样花更多的精力来阅读 Java JEP。只需在 JEP 标题中搜索“版本”一词即可将您带到JEP 223: New Version-String Scheme。通过学习JEP,你可以学到很多关于Java的精彩,比如records。 【参考方案1】:

&lt;java.version&gt;1.11&lt;/java.version&gt; 替换为&lt;java.version&gt;11&lt;/java.version&gt;

【讨论】:

感谢@Deepanshu (+1),但你是怎么知道的?它是否在某个地方的 Maven 工具文档中发布? 因为从 java 6 或 5 开始,他们放弃了“1”。从版本来看,没有java 1.11这样的东西,如果它准确回答了你的问题,请标记为已接受 问题是 &lt;java.version&gt;1.8&lt;/java.version&gt; 非常适合指定 Java 8。虽然你的答案确实有效,我确实想接受它,但我真的更喜欢 Oracle 或Maven(或某些权威!)解释了为什么 1.8 有效但 1.11 无效!再次感谢您的帮助! 换句话说@Deepanshu,你怎么知道&lt;java.version&gt;11&lt;/java.version&gt;是答案?我敢肯定它不只是在你的愿景中出现(!!!)所以无论你在哪里寻找答案都可能是我们需要在这里引用的正确来源。 从openjdk.java.net/jeps/223阅读这部分'从版本号中删除初始1元素'也看看***.com/questions/54467287/…【参考方案2】:

tl;博士

删除1. 前缀。

<java.version>11</java.version>

详情

Java 9+ 中的新版本控制方案

从 Java 9 及更高版本开始,Java 版本编号方案已更改为删除永不更改的 1.*

有关官方文档和解释,请参阅JEP 223: New Version-String Scheme从版本号中删除初始 1 元素部分

引用 JEP 223:

此提案从 JDK 版本号中删除了最初的 1 元素。也就是说,它表明 JDK 9 的第一个版本将具有版本号 9.0.0 而不是 1.9.0.0。

近二十年后,很明显,当前版本号方案的第二个元素是 JDK 事实上的 $MAJOR 版本号。

因此你的 POM 应该使用:

<java.version>11</java.version>

&lt;maven.compiler.release&gt;

顺便说一句,如果您将 POM 中与编译器、构建和测试相关的其他部分更新到最新版本,您可以将 &lt;maven.compiler.source&gt;&lt;maven.compiler.target&gt; 这对元素替换为简单的一个元素: &lt;maven.compiler.release&gt;.

所以你的 sn-p:

<properties>
  <java.version>1.11</java.version>
  <maven.compiler.source>$java.version</maven.compiler.source>
  <maven.compiler.target>$java.version</maven.compiler.target>
</properties>

…变成这样:

<properties>
  <java.version>11</java.version>
  <maven.compiler.release>$java.version</maven.compiler.release>
</properties>

在我自己的工作中,我什至没有java.version 元素。我简单地使用这个 sn-p,指定UTF-8 作为字符编码,Java 17 作为编译和构建版本。

  <properties>
      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      <maven.compiler.release>17</maven.compiler.release>
  </properties>

随着 UTF-8 成为跨平台的新 Java 18 默认值(请参阅 JEP 400: UTF-8 by Default),将来我可能会删除第一个元素 &lt;project.build.sourceEncoding&gt;

  <properties>
      <maven.compiler.release>17</maven.compiler.release>
  </properties>

这是我修改后的Apache Maven Quickstart Archetype,作为一个完整的例子。

<?xml version="1.0" encoding="UTF-8"?>

<!-- Modified by Basil Bourque as of 2021-11 to use the latest versions. -->
<project xmlns = "http://maven.apache.org/POM/4.0.0"
         xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation = "http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>work.basil.example</groupId>
    <artifactId>Quickie</artifactId>
    <version>1.0-SNAPSHOT</version>

    <name>Quickie</name>
    <url>http://www.basil.work</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.release>17</maven.compiler.release>
    </properties>

    <dependencies>

        <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>5.8.1</version>
            <scope>test</scope>
        </dependency>

    </dependencies>

    <build>
        <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
            <plugins>
                <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
                <plugin>
                    <artifactId>maven-clean-plugin</artifactId>
                    <version>3.1.0</version>
                </plugin>
                <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
                <plugin>
                    <artifactId>maven-resources-plugin</artifactId>
                    <version>3.2.0</version>
                </plugin>
                <plugin>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>3.0.0-M5</version>
                </plugin>
                <plugin>
                    <artifactId>maven-jar-plugin</artifactId>
                    <version>3.2.0</version>
                </plugin>
                <plugin>
                    <artifactId>maven-install-plugin</artifactId>
                    <version>3.0.0-M1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-deploy-plugin</artifactId>
                    <version>3.0.0-M1</version>
                </plugin>
                <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
                <plugin>
                    <artifactId>maven-site-plugin</artifactId>
                    <version>3.9.1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-project-info-reports-plugin</artifactId>
                    <version>3.1.2</version>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

【讨论】:

以上是关于将 Maven 插件升级到 Java 11的主要内容,如果未能解决你的问题,请参考以下文章

jdk8升级jdk11踩坑记录1

如何升级 maven 插件的版本?

升级java11后,maven命令打包报错

gradle插件升级到7.0.0出现的问题

JAVA面试常问知识总结——Maven

如何将 Android 项目升级到 Java 11