升级python-engineio后flask socketio出现packet is too large错误

报错信息：Unexpected error "packet is too large", closing connection socketio flask
你遇到的报错是python-engineio v4.0及以上版本新增的默认数据包大小限制导致的：该版本开始默认将单传输包的最大阈值设为1MB，超过阈值的包会被直接拦截并断开连接，老版本无该默认限制，因此升级前功能可正常运行。

1. 服务端（Flask-SocketIO）配置 #

初始化SocketIO实例时添加max_http_buffer_size参数，按需调整最大包阈值，单位为字节，示例设置为10MB：

from flask import Flask
from flask_socketio import SocketIO

app = Flask(__name__)
# 10MB对应的字节数：10 * 1024 * 1024 = 10485760
socketio = SocketIO(app, max_http_buffer_size=10 * 1024 * 1024)

2. 客户端（python-socketio[client]）配置 #

客户端需要同步调整相同的max_http_buffer_size参数，否则单侧配置不生效：

import socketio

# 和服务端保持一致，配置为10MB
sio = socketio.Client(max_http_buffer_size=10 * 1024 * 1024)

如果常规传输的包大小远超过10MB，不建议将阈值设置过高，避免服务端面临大流量攻击风险，可选择以下方案优化：

• 分片传输：将大数据拆分为多个1MB以内的小包按顺序发送，接收端接收完成后拼接还原
• 数据压缩：发送前用gzip等工具压缩数据，接收端解压后使用，大幅降低单包体积
• 旁路传输：超大数据改用HTTP接口上传/下载，SocketIO仅传输控制指令和元数据

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