GCP App Engine部署Flask API遇CORS及app.yaml部署异常问题求解

一、修复部署时「找不到app.yaml」的报错 #

这个报错是两方面原因共同导致的，按顺序排查即可：

• 先核对文件位置
  确认app.yaml和main.py、依赖声明文件放在同一个项目根目录，没有放在子文件夹，文件名严格为app.yaml，不要出现大小写偏差、后缀写错（比如写成app.yml）的情况。
• 修正app.yaml的语法错误（核心原因）
  你当前配置里的handlers段是App Engine标准环境专用的路由规则，弹性环境完全不支持该字段，无效配置会导致部署工具解析失败，误判为没有合法的app.yaml文件。
  弹性环境下可用的app.yaml正确写法如下，把原来的handlers相关配置全部删掉即可：

  runtime: python
  env: flex
  entrypoint: gunicorn -b :$PORT main:app --timeout 220
  runtime_config:
    python_version: 3.7 # 原配置的3.6版本已停止服务支持，建议升级到受支持的版本
  # 需要全局加响应头时，弹性环境的http_headers为顶级配置项，不要嵌套在handlers下
  http_headers:
    Access-Control-Allow-Origin: '*'
  

二、修复跨域头缺失的报错 #

你之前写的CORS配置没有生效，主要有三个问题需要调整：

• 清理重复、废弃的导入代码
  现有Flask代码里重复导入了两次CORS模块，其中flask.ext.cors是早已废弃的老版本导入方式，容易导致配置失效，删掉这行废弃导入：

  #!flask/bin/python
  from flask import Flask, jsonify, request
  from flask_cors import CORS, cross_origin
  
  app = Flask(__name__)
  # 全局初始化CORS配置，覆盖所有路由
  CORS(app, resources={r"/*": {"origins": "*"}})
  app.config['CORS_HEADERS'] = 'Content-Type'
  
  # *路由方法要加上OPTIONS，用于处理浏览器跨域预检请求*，否则即使加了CORS装饰器，预检请求也会被拦截
  @app.route('/companyInfoFull', methods=['GET', 'OPTIONS'])
  @cross_origin()
  def company_info_full():
      # 原业务逻辑代码
      pass
  

• 配置优先级说明
  优先用Flask代码内的CORS配置处理跨域，不要只依赖app.yaml里的静态响应头：
  浏览器跨域校验会先发OPTIONS预检请求做权限确认，仅靠app.yaml加的固定Access-Control-Allow-Origin头，无法正确响应预检逻辑，依然会报跨域错误。如果已经用Flask-CORS做好了代码内配置，甚至可以删掉app.yaml里的http_headers段，避免重复添加响应头导致浏览器校验失败。
• 依赖检查
  确保项目根目录的依赖声明文件里添加了最新版本的flask-cors，部署时会自动安装对应依赖，避免模块加载失败导致CORS配置不生效。

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