Windows 10安装App Engine Java组件时gcloud崩溃原因排查

可能的原因 #

• 文件下载不完整/损坏：安装组件时网络波动，导致Jetty演示模块中的图片文件未成功下载到临时 staging 目录，安装过程中找不到该文件。
• Windows路径长度限制：报错的文件路径远超Windows默认的260字符路径限制，系统无法识别该长路径，进而触发找不到文件的错误。
• 权限不足：当前用户对Cloud SDK的临时 staging 目录没有足够的读写权限，导致文件无法正常写入或读取。

解决方法 #

1. 修复SDK组件 #

执行以下命令让SDK自动检测并修复缺失或损坏的文件：

gcloud components repair

修复完成后，重新运行安装命令：

gcloud components install app-engine-java

2. 处理长路径问题 #

• 缩短安装路径：卸载当前Cloud SDK，重新安装到更浅的目录（例如C:\gcloud-sdk），避免深层嵌套的长路径。
• 启用Windows长路径支持：
  1. 打开组策略编辑器（运行gpedit.msc），依次进入计算机配置 > 管理模板 > 系统 > 文件系统，找到并启用「启用Win32长路径」选项。
  2. 或修改注册表：打开注册表编辑器（运行regedit），定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem，将LongPathsEnabled的值改为1（若不存在则新建DWORD值）。
     完成后重启系统，再重试安装。

3. 清理临时目录后重试 #

手动删除临时 staging 目录：

C:\Users\Wizy\AppData\Local\Google\Cloud SDK\google-cloud-sdk.staging

删除后重新执行安装命令。

4. 提升权限运行命令行 #

右键点击命令提示符或PowerShell，选择「以管理员身份运行」，再执行gcloud components install app-engine-java命令，避免权限不足导致的文件操作失败。

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