GCP App Engine中gunicorn处理signal:term，请求后Worker退出问题

核心原因分析 #

从日志可见，gunicorn主进程收到TERM信号后触发所有worker退出，结合GCP App Engine的运行机制，核心问题有两点：

1. 健康检查未通过：App Engine会定期向实例发送健康检查请求（默认路径/_ah/health），若应用未正确响应该请求，平台会判定实例不健康，发送TERM信号终止进程并重启。
2. 会话存储机制不兼容：本地运行时Flask默认使用内存会话，部署后worker频繁重启或多worker环境下，内存会话无法跨进程共享，导致登录状态无法保持。

具体修复步骤 #

1. 实现健康检查路由 #

在Flask应用中添加健康检查接口，确保返回200状态码：

from flask import Flask
app = Flask(__name__)

# 健康检查路由，必须实现
@app.route('/_ah/health')
def health_check():
    return 'OK', 200

# 你的其他业务路由...

2. 调整gunicorn启动配置 #

修改app.yaml中的启动命令，确保绑定正确端口、设置合理超时参数：

runtime: python39
# 配置gunicorn参数：绑定8080端口（App Engine默认转发端口）、设置超时、合理的worker/线程数
entrypoint: gunicorn --workers=2 --threads=4 --timeout=120 --bind=0.0.0.0:8080 main:app

• --bind=0.0.0.0:8080：必须绑定8080端口，App Engine会将外部流量转发到这个端口（日志中之前用8081是错误配置）
• --timeout=120：延长超时时间，避免正常请求被误判为超时
• --workers和--threads：根据实例规格调整，平衡并发能力与资源占用

3. 替换会话存储为持久化方案 #

放弃Flask默认的内存会话，改用跨进程共享的持久化存储，比如使用GCP Memorystore Redis服务：

from flask import Flask
from flask_session import Session
import redis

app = Flask(__name__)
# 设置会话类型为Redis
app.config['SESSION_TYPE'] = 'redis'
# 配置Redis连接（替换为你的Memorystore Redis实例地址）
app.config['SESSION_REDIS'] = redis.Redis(host='your-redis-instance-ip', port=6379)
# 必须设置加密密钥
app.secret_key = 'your-strong-secret-key-here'

# 初始化会话扩展
Session(app)

也可以选择Google Cloud Datastore作为会话存储，对应调整SESSION_TYPE为datastore即可。

4. 验证日志与状态 #

部署后查看App Engine日志，确认健康检查请求返回200，且不再出现频繁的worker退出日志，同时测试登录状态是否能正常保持。

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