Added a default value for the WebSocket communication size limit.

问题场景

用户在使用 Dify 的 Cloud 版本时，创建或导入一个大型工作流。当工作流的 DSL/配置文件超过 1 MB 后，在浏览器中打开工作流编排/编辑器页面，页面会反复处于“同步中”状态，WebSocket 连接不断断开并重连，最终导致工作流无法在 UI 中正常编辑。

报错原文

Added a default value for the WebSocket communication size limit.
socketio.Server initialized without explicit max_http_buffer_size, defaults to 1 MB in engine.io.
WebSocket frames rejected by server when workflow exceeds 1 MB.
Page repeatedly shows syncing state, WebSocket keeps disconnecting and reconnecting.
Workflow cannot be edited in the UI.

原因分析

根据 Issue 中的技术分析，socketio.Server 在初始化时未显式设置 max_http_buffer_size，而 engine.io 的默认值为 1 MB。当工作流协同子系统发送大负载数据（例如包含完整图快照的 sync_request 事件）时，超过 1 MB 的 WebSocket 帧会被服务端拒绝，从而触发客户端反复重连和 HTTP 回退请求（/draft）。

Issue 中同时提到，此前已有两个相关修复（#39587 和 #40191）解决了 WebSocket 重连风暴和本地编辑回退，但均未处理消息大小上限问题，这是大型工作流场景下的独立根因。

环境排查

• 确认 Dify 版本是否为 1.16.1 或更早版本（Cloud 环境已复现）。
• 检查工作流 DSL/配置文件大小是否超过 1 MB。
• 若为自托管部署，检查 api/extensions/ext_socketio.py 中 socketio.Server 是否设置了 max_http_buffer_size。
• 确认 WEBSOCKET_MAX_HTTP_BUFFER_SIZE 环境变量是否已定义（若使用最新代码）。

解决步骤

1. 若使用 Dify Cloud，请确认是否为平台侧已修复（Issue 已关闭），可直接重试导入大型工作流。
2. 若为自托管部署且问题仍在，需修改 api/extensions/ext_socketio.py 中的 socketio.Server 初始化，显式传入 max_http_buffer_size 参数，例如 10 * 1024 * 1024（10 MB）。
3. 建议在环境变量中加入 WEBSOCKET_MAX_HTTP_BUFFER_SIZE（如 10 MB），并在 docker/.env.example 中添加对应配置项，以便灵活调整。
4. 重新构建并重启 Dify API 服务，确保修改生效。

验证方法

按以下步骤验证问题是否已解决：

1. 重新导入或创建一个大于 1 MB 的工作流 DSL。
2. 打开工作流编排页面，观察页面是否不再反复显示“同步中”状态。
3. 打开浏览器 DevTools 的 Network 面板，确认 WebSocket 连接保持稳定，不再出现频繁的 /draft HTTP 请求。
4. 尝试在工作流编辑器中执行编辑并保存，确认操作正常。

参考来源

langgenius/dify #41331

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。