GCP App Engine部署Flask应用遇404，无实例创建但本地正常

核心排查点与解决方案 #

1. 修正entrypoint端口配置 #

你的app.yaml中entrypoint硬编码了8080端口，但Google App Engine会通过$PORT环境变量分配端口，硬编码端口会导致服务无法被平台检测到健康状态，进而启动失败、部署超时。修改entrypoint为：

entrypoint: gunicorn --bind 0.0.0.0:$PORT --timeout 600 app:app

2. 消除配置冲突 #

script: auto与自定义entrypoint可能存在逻辑冲突，App Engine Python 3.11运行时在指定entrypoint时，可简化handler配置确保逻辑统一：

runtime: python311
handlers:
-  url: /static
   static_dir: static
- url: /.*
  script: auto
entrypoint: gunicorn --bind 0.0.0.0:$PORT --timeout 600 app:app 
manual_scaling:
  instances: 1

（注：若保留entrypoint，script: auto仍可正常工作，但需确保entrypoint命令正确）

3. 确认依赖完整性 #

本地运行正常不代表云端依赖齐全，必须在项目根目录创建requirements.txt，包含所有依赖（包括gunicorn），示例：

Flask==2.3.3
gunicorn==21.2.0
# 其他你的应用依赖包

部署时App Engine会自动安装这些依赖，缺少关键依赖会导致服务启动失败。

4. 查看详细部署日志 #

执行部署命令时添加调试参数，获取具体错误信息：

gcloud app deploy --verbosity=debug

日志会暴露依赖安装失败、权限错误、服务启动超时等具体问题，是定位根源的关键。

5. 验证服务账号权限 #

确保部署使用的服务账号拥有以下核心权限：

• App Engine Admin
• Cloud Storage Object Admin
• App Engine Deployer
  可在IAM控制台为App Engine默认服务账号（[project-id]@appspot.gserviceaccount.com）添加对应角色，避免因权限不足导致资源创建失败。

6. 检查存储桶状态 #

确认新建项目的暂存存储桶（staging.<project-id>.appspot.com）和默认存储桶（<project-id>.appspot.com）存在且权限正确，部署过程中需要上传代码至这些存储桶，若存储桶无法访问会导致部署卡住。

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