gcloud app deploy部署PHP7.4应用报composer-runtime-api ^2.0.0缺失错误如何解决

问题根因 #

jean85/pretty-package-versions 2.x版本要求Composer 2提供的composer-runtime-api ^2.0.0接口，虽然你在GAE交互式控制台查到的Composer版本为2.1.6，但构建阶段使用的旧版PHP7.4构建镜像内置的Composer安装流程默认调用Composer 1，因此触发依赖不匹配错误。

可行解决方案 #

• 方案一：降级兼容包（最快生效）
  修改composer.json中jean85/pretty-package-versions的版本约束为兼容Composer 1的1.x分支：

"jean85/pretty-package-versions": "^1.5"

修改完成后本地执行composer update jean85/pretty-package-versions生成新的composer.lock文件，重新执行部署即可。

• 方案二：强制构建阶段使用Composer 2
  在你的app.yaml配置文件中添加环境变量指定Composer版本：

env_variables:
  COMPOSER_VERSION: '2'

添加后重新部署，构建流程会自动切换到Composer 2执行依赖安装。

• 方案三：本地预构建依赖后部署
  本地执行composer install --no-dev --optimize-autoloader生成vendor目录，再修改app.yaml的skip_files配置，取消默认跳过vendor目录的规则：

skip_files:
  - ^(.*/)?#.*#$
  - ^(.*/)?.*~$
  - ^(.*/)?.*\.py[co]$
  - ^(.*/)?.*/RCS/.*$
  - ^(.*/)?\..*$
  # 移除默认的vendor目录跳过规则

部署时会直接上传本地生成的vendor目录，构建阶段不会重新安装依赖，可规避构建环境的Composer版本问题。

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