部署在Heroku上的Flask-SocketIO应用使用Gunicorn时出现超时错误求助

问题根源 #

你代码中的app.run()是Flask内置开发服务器的启动语句，Gunicorn启动时会导入application模块获取app对象，此时这行代码会被直接执行，自动启动Flask开发服务器，导致Gunicorn的worker无法正常接管请求处理逻辑。超过Heroku默认的30秒请求超时阈值后，就会触发H12错误，worker被系统杀死后不断重启，就出现了你看到的日志循环现象。
你看到的「使用开发服务器」警告，正是因为实际运行的是Flask自带的开发服务器，而非你预期的Gunicorn生产服务器。

修复步骤 #

1. 修改application.py代码，将app.run()包裹在if __name__ == '__main__'判断中，避免模块被导入时自动执行开发服务器启动逻辑：

from flask import Flask, render_template
from flask_socketio import SocketIO
import os

app = Flask(__name__)
app.secret_key = os.environ.get('SECRET')
socketio = SocketIO(app)

@app.route("/")
def index():
    return render_template("index.html")

# 仅直接运行当前脚本时才启动开发服务器
if __name__ == '__main__':
    app.run()

2. 后续本地调试SocketIO功能时，可将app.run()替换为socketio.run(app)，同样放在上述判断块内即可。
3. 你现有的requirements.txt和Procfile配置无需修改，重新推送到Heroku部署即可正常运行。

提示：Flask-SocketIO应用如果需要开启多worker部署，需要额外配置Redis、RabbitMQ等作为消息中间件同步跨worker的SocketIO消息，当前单worker配置可以满足基础使用需求。

内容的提问来源于stack exchange，提问作者joe six-pack