appengine-maven-plugin:2.8.1部署报错：误判Java App Engine组件未安装求解决

使用appengine-maven-plugin:2.8.1执行deploy目标构建失败，插件抛出AppEngineJavaComponentsNotInstalledException，提示需执行gcloud components install app-engine-java安装Java App Engine组件，但实际该组件已安装，执行更新命令时显示"All components are up to date."

错误日志 #

[INFO] --- appengine-maven-plugin:2.8.1:deploy (default-cli) @ licence-server ---
[INFO] Staging the application to: c:\Source\wylas\wylas-licence-server\server\licence-server\target\appengine-staging
[INFO] Detected App Engine appengine-web.xml based application.
[INFO] Deleting the staging directory: c:\Source\wylas\wylas-licence-server\server\licence-server\target\appengine-staging
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  2.081 s
[INFO] Finished at: 2024-12-05T11:06:44+10:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal com.google.cloud.tools:appengine-maven-plugin:2.8.1:deploy (default-cli) on project licence-server: Execution default-cli of goal com.google.cloud.tools:appengine-maven-plugin:2.8.1:deploy failed: com.google.cloud.tools.appengine.operations.cloudsdk.AppEngineJavaComponentsNotInstalledException: Validation Error: Java App Engine components not installed. Fix by running 'gcloud components install app-engine-java' on command-line. -> [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/PluginExecutionException

当前环境信息 #

GCloud组件版本 #

c:\Source\wylas\wylas-licence-server\server\licence-server>gcloud version
Google Cloud SDK 502.0.0
app-engine-java 2.0.31
app-engine-python 1.9.114
beta 2024.11.15
bq 2.1.9
cloud-datastore-emulator 2.3.1
core 2024.11.15
gcloud-crc32c 1.0.0
gsutil 5.31

Java版本 #

c:\Source\wylas\wylas-licence-server\server\licence-server>java --version
openjdk 17.0.5 2022-10-18
OpenJDK Runtime Environment OpenLogic-OpenJDK (build 17.0.5+8-adhoc..jdk17u)
OpenJDK 64-Bit Server VM OpenLogic-OpenJDK (build 17.0.5+8-adhoc..jdk17u, mixed mode)

Maven版本 #

c:\Source\wylas\wylas-licence-server\server\licence-server>mvn -v
Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: C:\Dev\apache-maven-3.9.9
Java version: 17.0.8, vendor: OpenLogic, runtime: C:\Dev\jdk-17.0.8.7
Default locale: en_AU, platform encoding: Cp1252
OS name: "windows 11", version: "10.0", arch: "amd64", family: "windows"

可行解决办法 #

• 检查Maven调用的gcloud路径：执行mvn -X deploy查看日志中gcloud的实际调用路径，对比终端执行where gcloud的结果，确保Maven使用的是已安装组件的gcloud实例。
• 重装app-engine-java组件：先执行gcloud components remove app-engine-java卸载组件，再执行gcloud components install app-engine-java重装，修复可能的安装缓存或文件损坏问题。
• 升级appengine-maven-plugin版本：2.8.1版本较旧，尝试升级到最新稳定版（如3.x系列），修改pom.xml中的插件版本：

  <plugin>
    <groupId>com.google.cloud.tools</groupId>
    <artifactId>appengine-maven-plugin</artifactId>
    <version>3.5.0</version> <!-- 替换为最新可用版本 -->
  </plugin>
  

• 验证环境变量：确保CLOUDSDK_ROOT_DIR指向正确的Google Cloud SDK安装目录，且SDK的bin目录已添加到系统PATH中。
• 以管理员身份运行命令：Windows下权限限制可能导致组件无法被识别，用管理员权限打开终端后重新执行mvn appengine:deploy。

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