部署Flask至Google Cloud App Engine遇502错误及端口占用问题

嘿，我之前部署Flask到App Engine时也踩过类似的坑，咱们一步步来捋清楚问题所在：

首先，理解端口占用错误的原因 #

你SSH进去手动运行python app.py时出现OSError: [Errno 98] Address already in use，是因为App Engine平台已经按照你的配置启动了应用进程，它已经占用了分配的端口。这时候你再手动启动一个Flask实例，自然会端口冲突啦。

为什么会出现502错误？ #

502通常意味着App Engine无法正确连接到你的应用进程，大概率是启动配置或者应用本身的问题，我们从这几个方向排查：

1. 检查app.yaml的entrypoint配置 #

App Engine默认需要用生产级的WSGI服务器（比如gunicorn）来启动Flask，而不是本地开发用的Flask自带服务器。你的app.yaml里一定要正确配置entrypoint，比如：

runtime: python39 # 换成你实际使用的Python版本
entrypoint: gunicorn -b :$PORT app:app

这里的$PORT是App Engine自动分配的环境变量，绝对不能硬写固定端口（比如5000），否则平台无法正确路由请求，直接导致502。

2. 确保Flask代码监听正确的地址和端口 #

即使你用gunicorn启动，代码里最好也兼容环境变量的端口设置，避免本地和云端不一致：

import os
from flask import Flask

app = Flask(__name__)

# 你的路由和业务逻辑代码...

if __name__ == '__main__':
    port = int(os.environ.get('PORT', 5000)) # 本地默认用5000，云端自动读取平台分配的PORT
    app.run(host='0.0.0.0', port=port) # 监听0.0.0.0才能让外部访问到应用

3. 排查依赖缺失问题 #

本地虚拟环境正常，但云端可能漏掉了依赖包。检查你的requirements.txt，确保包含了所有必要的包，包括gunicorn（如果用它的话）：

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

部署时App Engine会自动安装这些依赖，遗漏的话会导致应用启动失败，进而出现502。

4. 查看App Engine日志（比SSH调试更高效） #

与其手动SSH进去试错，不如先看GCP控制台的日志：

• 打开GCP控制台 -> App Engine -> 日志
• 切换到“请求日志”和“应用日志”，里面会显示应用启动时的具体错误信息（比如模块导入失败、环境变量未设置等），这是定位问题最快的方式。

如果一定要SSH调试怎么办？ #

如果你非要手动启动应用测试，先杀掉已经运行的进程：

1. 用ps aux | grep python找到占用端口的进程ID
2. 用kill <进程ID>终止进程
3. 然后用平台分配的端口启动：python app.py --port $PORT（或者按照代码里的逻辑自动读取环境变量）

另外，那个WARNING: Do not use the development server in a production environment是Flask自带服务器的提醒，云端一定要用gunicorn这类生产级服务器，别用Flask自带的开发服务器哦！

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