使用Maven构建Hello Endpoint Framework时appengine-maven-plugin运行失败

问题背景 #

我尝试通过Maven原型创建Endpoints Framework项目，执行了以下构建命令：

mvn archetype:generate -Dappengine-version=1.9.63 -Djava8=true -DCloudSDK_Tooling=false -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:

我设置-Djava8=true是为了让项目运行在Java8环境下，但生成的pom.xml中编译版本依然是1.7。执行mvn clean package完成构建后，运行mvn appengine:run时出现错误：appengine-maven-plugin:1.3.1 run failed non zero exit。添加-e参数重新运行后，看到插件有可用更新，且多个核心Maven插件未显式指定版本的警告。

核心问题分析 #

1. Java版本配置冲突：命令指定了Java8，但pom.xml的编译参数仍为1.7，导致运行时环境不兼容
2. 插件版本过时/未显式指定：appengine-maven-plugin和endpoints-framework-maven-plugin有可用更新，且部分核心插件依赖Super POM的默认版本，可能引发兼容性问题

修复步骤 #

1. 修正Java编译版本

修改pom.xml中的properties部分，将编译版本改为1.8：

<properties>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

2. 更新插件版本并显式指定核心插件

根据警告提示更新插件版本，并显式添加核心Maven插件的版本配置：

<build>
  <outputDirectory>${project.build.directory}/${project.build.finalName}/WEB-INF/classes</outputDirectory>
  <plugins>
    <!-- 更新App Engine插件到最新可用版本1.3.2 -->
    <plugin>
      <groupId>com.google.cloud.tools</groupId>
      <artifactId>appengine-maven-plugin</artifactId>
      <version>1.3.2</version>
      <configuration>
        <!-- 可添加部署相关配置 -->
      </configuration>
    </plugin>
    <!-- 更新Endpoints插件到最新可用版本1.0.3 -->
    <plugin>
      <groupId>com.google.cloud.tools</groupId>
      <artifactId>endpoints-framework-maven-plugin</artifactId>
      <version>1.0.3</version>
      <configuration>
        <!-- 替换为你的实际项目ID -->
        <hostname>your-app-id.appspot.com</hostname>
      </configuration>
    </plugin>
    <!-- 显式指定核心插件版本，避免依赖默认版本 -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.7.0</version>
    </plugin>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-war-plugin</artifactId>
      <version>3.2.0</version>
    </plugin>
    <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>versions-maven-plugin</artifactId>
      <version>2.1</version>
      <executions>
        <execution>
          <phase>compile</phase>
          <goals>
            <goal>display-dependency-updates</goal>
            <goal>display-plugin-updates</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

3. 验证应用ID一致性

确保创建项目时指定的-Dapplication-id=your-app-id与endpoints-framework-maven-plugin配置中的hostname完全一致，避免因ID不匹配导致的错误。

4. 重新构建并启动项目

执行以下命令完成重新构建和启动：

mvn clean package
mvn appengine:run

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