Flask集成Socket.io运行崩溃，webhook触发后报错如何解决？

报错原因说明 #

你遇到的Cannot retrieve the function header报错来自你项目中集成的Flask监控仪表盘组件，另外的安全密钥警告、SocketIO消息不生效问题是配置顺序、使用方式错误导致的，按以下步骤修复即可：

修复步骤 #

1. 解决监控组件报错 #

• 把webhook.py里的from app import socketio导入语句移到文件顶部，不要放在put方法内部，动态导入会导致监控组件无法采集接口函数的元数据
• 不需要监控功能的话可以直接注释掉app.py里dashboard.config.init_from、dashboard.bind两行初始化代码，即可同时解决Scheduler is already running的警告

2. 修复SocketIO推送逻辑 #

修改webhook.py代码，补充广播参数保证所有连接的客户端都能收到通知：

# 导入移到文件顶部
from app import socketio

def put(self):
    # 加broadcast参数实现全局广播
    socketio.emit('dados', broadcast=True)
    # 如果需要直接触发图表数据更新，也可以直接调用生成数据的方法
    # from app import background_task_func
    # background_task_func()
    return {"status": "success"}, 200

3. 修复前端配置错误 #

• 删掉window.onload里重复初始化Socket连接的代码，同一页面只需要初始化一次Socket实例
• 补充dados事件的逻辑，收到webhook触发通知后主动拉取最新图表数据：

socket.on('dados', function() {
    console.log('收到更新通知');
    // 主动请求最新数据
    socket.emit('response_demo');
});

4. 修复服务端配置顺序和跨域 #

修改app.py的配置顺序，把SECRET_KEY配置移到SocketIO初始化之前，同时补充SocketIO的跨域配置，解决安全密钥警告：

app = Flask(__name__)
# 先配置SECRET_KEY
app.config['SECRET_KEY'] = "secret"
# 再初始化SocketIO，补充跨域配置
socketio = SocketIO(app, cors_allowed_origins="*")

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