2014年Google App Engine Python旧项目新版部署失败求助

嘿，我太懂这种时隔多年挖出来老项目部署的酸爽了——Google App Engine这几年的变化真的不小，尤其是部署流程和配置要求，跟2014年那会完全不是一回事儿。结合你目前遇到的问题，我给你梳理几个关键的解决方向：

你用gsutil cp直接上传文件的方式是早期的旧版部署流程，现在GAE官方已经主推gcloud app deploy命令（属于Google Cloud SDK的一部分）。这个工具会自动帮你做配置校验、依赖打包、环境适配这些事儿，比手动传文件靠谱太多了。

• 先安装最新版的Google Cloud SDK，然后切换到你的项目根目录，直接运行：

  gcloud app deploy
  

• 另外提一句：完全不需要把app.yaml转成JSON！现在GAE依然原生支持yaml格式的配置文件，转格式反而容易引入不必要的错误，直接用原来的app.yaml（按新规范修改后）就行。

你说首次部署因「缺少部署信息」失败，大概率是旧的app.yaml配置不符合现在GAE的要求。2014年的配置字段和现在差异很大，核心要补的几个点：

• 必须指定runtime字段：Python项目现在要写runtime: python39（或者你代码兼容的Python3.x版本，Python2.7已经彻底不支持了）
• 明确entrypoint字段：告诉GAE怎么启动你的应用，比如Flask项目可能是entrypoint: gunicorn -b :$PORT main:app
• 检查env和service字段：现在默认是env: standard（标准环境），如果你的旧项目是灵活环境，要对应配置env: flex

给你个符合当前规范的基础app.yaml示例参考：

runtime: python39
env: standard
service: default
entrypoint: gunicorn -b :$PORT main:app

handlers:
- url: /.*
  script: auto

2014年的Python代码大概率依赖旧版GAE专属API（比如google.appengine.api这类模块），而现在的GAE标准环境已经不再支持这些旧API了，得做迁移：

• 替换旧服务：用Google Cloud的通用服务替代，比如用google-cloud-storage代替旧的Blobstore API，用google-cloud-datastore代替旧的Datastore API
• 更新依赖：把旧的GAE专属依赖换成当前支持的包，在requirements.txt里明确列出所有依赖，gcloud app deploy会自动帮你安装这些包

如果还是部署失败，别瞎猜，去Google Cloud Console的「App Engine -> 版本 -> 日志」里看详细错误日志，里面会明明白白告诉你缺了什么配置、哪里代码报错、或者权限有问题。比如如果是权限不足，就给你的账号加上项目部署权限；如果是代码语法错误，日志里会有具体的报错栈帮你定位。

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