部署简单Flask应用至GCloud时出现Internal Server Error问题

本地运行Flask应用完全正常，但部署到Google Cloud后出现Internal Server Error，怀疑是app.yaml配置问题。另外，日志中的project_id和clone_id属于敏感标识，公开时建议替换为占位符（你已做处理）。

报错信息 #

Internal Server Error

The server encountered an internal error and was unable to complete your request. Either the server is overloaded or there is an error in the application.

相关代码与配置 #

main.py #

from flask import Flask
import requests

app = Flask(__name__)

@app.route("/")
def data():
    response = requests.request("GET", "https://jsonplaceholder.typicode.com/posts")
    data = response.json()
    return(data)

returned_data = data()

#for i, item in enumerate(returned_data):

#    userID = item.get("userID", None)
#    id = item.get("id", None)
#    title = item.get("id", None)

#    print(userID,id,title)
    
if __name__ == "__main__":
    app.run(host='127.0.0.1', port=8080, debug=True)

app.yaml #

runtime: python39
entrypoint: gunicorn -b :$PORT -w 2 main:app

requirements.txt #

requests
Flask==2.1.0
gunicorn

日志信息 #

{
insertId: "63604ebd000c8d09af3f2e13"
labels: {
clone_id: "00c61b114F0e8fb053d8ebee071db45f9aa9ec947906c0029f3b30b22f414ae90868c30c989456619d667de0e08ca37e2598be2ed37ad5d3b"
}
logName: "projects/XXXX/logs/%2Fvar%2Flog%2Fgoogle_init.log"
receiveTimestamp: "2022-10-31T22:39:58.016186551Z"
resource: {
labels: {
module_id: "default"
project_id: "XXXX"
version_id: "20221031t161907"
zone: "us6"
}
type: "gae_app"
}
textPayload: "[start] 2022/10/31 22:39:57.821966 Start program failed: termination triggered by nginx exit"
timestamp: "2022-10-31T22:39:57.822537Z"
}

问题根源与修复方案 #

• 核心问题：main.py中全局作用域直接调用returned_data = data()，导致Gunicorn启动应用时，Flask上下文未初始化就执行HTTP请求，引发启动失败，最终触发nginx退出（对应日志提示）。本地运行时，代码在if __name__ == "__main__"块后执行，上下文已初始化，所以无问题。
• 修复步骤：
  1. 移除main.py中全局的returned_data = data()调用，若需要初始化数据，可移至路由函数内部或使用Flask的before_first_request装饰器在首次请求前执行。修改后的代码：

     from flask import Flask
     import requests
     
     app = Flask(__name__)
     
     @app.route("/")
     def data():
         response = requests.request("GET", "https://jsonplaceholder.typicode.com/posts")
         data = response.json()
         return(data)
     
     if __name__ == "__main__":
         app.run(host='127.0.0.1', port=8080, debug=True)
     

  2. 重新部署应用到Google Cloud。
• 额外检查：
  • 确认requirements.txt依赖版本在Python 3.9环境下兼容，无版本冲突。
  • 若问题仍存在，通过Google Cloud Console查看gae_app类型的应用日志（而非google_init.log），获取详细错误堆栈定位问题。

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