GCP App Engine部署Laravel PHP 8.1遇版本指定错误求助

针对你遇到的“composer.json中未指定PHP运行时版本，或指定版本不被支持”报错，即使已经配置了php8.1，可按以下步骤排查修复：

1. 修复composer.json的JSON语法错误 #

你提供的composer.json片段中，"php": "^8.1",末尾多了一个逗号，这会导致JSON解析失败，App Engine无法识别指定的PHP版本。修正后的完整require节点示例：

"require": {
    "php": "^8.1"
}

确保整个composer.json是合法的JSON格式，没有多余的逗号或语法错误。

2. 确认文件位置与构建上下文 #

• composer.json必须放在项目根目录，和app.yaml处于同一层级，Cloud Build才能正确读取。
• 检查.gcloudignore或.gitignore文件，确保没有将composer.json排除在构建上下文之外，否则Cloud Build会忽略该文件。

3. 优化app.yaml配置 #

在app.yaml中明确runtime_config，强化版本指定：

runtime: php81
runtime_config:
  document_root: .

注意runtime字段必须是php81（小写无连字符），这是App Engine PHP8.1运行时的正确标识。

4. 在Cloud Build步骤中显式处理composer #

修改cloudbuild.yaml，先执行composer依赖安装，确保配置被正确加载：

steps:
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: 'bash'
    args:
        - '-c'
        - |
          composer install --no-dev --optimize-autoloader \
          && gcloud config set app/cloud_build_timeout 3600 \
          && gcloud app deploy -q --promote -v=$BUILD_ID \
          --project=$PROJECT_ID

timeout: '3600s'

这一步会在构建过程中先处理composer依赖，确保App Engine能正确识别PHP版本配置。

5. 验证本地配置并重新提交 #

在本地项目根目录执行以下命令，确认composer配置有效：

composer show -p

输出中应显示PHP版本为8.1.x，确认无误后将修正后的代码提交到代码仓库，重新触发Cloud Build部署。

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