Excalidraw支持WebSocket长连接，实时同步更稳定

Excalidraw 与 WebSocket：构建实时协作白板的技术实践

在远程协作日益成为工作常态的今天，团队对“所见即所得”协同编辑工具的需求早已超越了简单的文档共享。尤其是在技术设计、产品原型讨论和系统架构推演等场景中，一张能即时响应多人操作的虚拟白板，往往比千言万语更高效。

Excalidraw 正是在这样的背景下脱颖而出——它不仅仅是一个手绘风格的绘图工具，更是一个以低延迟同步为核心目标的协作平台。而支撑其流畅体验的关键，并非复杂的前端渲染，而是底层通信机制的一次关键演进：从 HTTP 轮询到WebSocket 长连接的全面切换。

传统基于轮询的协作方案有个致命弱点：你永远在“拉”，而不是“被通知”。每隔几百毫秒向服务器问一次“有没有新变化”，不仅浪费带宽，还会让操作反馈产生明显卡顿。当三个人同时在画布上拖动元素时，画面错乱几乎是必然结果。

WebSocket 的引入彻底改变了这一局面。它像在客户端和服务端之间架起了一条永不挂断的电话线，任何一方都能随时说话。当你画出一条箭头，这个动作几乎瞬间就能出现在协作者屏幕上，无需等待下一轮请求。

这背后的技术逻辑其实并不复杂，但设计精巧：

1. 客户端通过标准 HTTP 发起一个带有Upgrade: websocket头的握手请求；
2. 服务端返回 101 Switching Protocols，完成协议升级；
3. TCP 连接保持打开，双方进入全双工通信模式，可以随时互发消息。

整个过程只需要一次握手，之后所有的数据交换都基于同一个持久连接进行。相比每次都要重新建立 HTTPS 连接的轮询机制，这种模式无论是延迟还是资源消耗都实现了数量级的优化。

在 Excalidraw 中，每个共享白板对应一个“房间”，多个用户加入后，各自的浏览器会与后端 WebSocket 服务建立长连接。每当有人执行操作——比如添加矩形、修改文本或移动元素——前端就会将这次变更序列化为一条轻量级 JSON 消息：

{ "type": "add", "element": { "id": "rect-abc123", "type": "rectangle", "x": 100, "y": 200, "width": 150, "height": 80 } }

这条消息通过socket.send()推送到服务端，再由服务端广播给房间内其他成员。接收方收到后调用本地渲染函数更新视图，整个流程通常在几十毫秒内完成。

const socket = new WebSocket('wss://excalidraw.com/socket'); socket.onopen = () => { console.log('Connected to collaboration server'); socket.send(JSON.stringify({ type: 'join-room', roomId: 'board-12345' })); }; socket.onmessage = (event) => { const message = JSON.parse(event.data); switch (message.type) { case 'remote-update': applyRemoteElements(message.elements); break; case 'cursor-move': updateOtherUserCursor(message.userId, message.x, message.y); break; } };

这段代码看似简单，却是实时协作的基础骨架。值得注意的是，Excalidraw 并没有选择封装过重的 Socket.IO，而是直接使用原生 WebSocket API。这样做虽然牺牲了一些自动重连、命名空间管理等功能，但却换来更高的透明度和更低的传输开销——对于追求极致响应速度的应用来说，这是值得的权衡。

当然，光有通道还不够。真正的挑战在于如何保证多用户并发编辑下的状态一致性。

Excalidraw 的做法是采用“中心化协调 + 增量同步”的架构。所有变更必须经由服务端中转，避免点对点直连带来的拓扑复杂性。服务端扮演着“裁判员”的角色，负责消息路由、冲突消解和房间生命周期管理。

目前主流部署版本多采用最后写入优先（LWW）策略处理冲突。虽然不如 OT 或 CRDT 理论上严谨，但在实际使用中足够有效，且实现成本极低。更重要的是，Excalidraw 强调“本地优先”原则：即使网络中断，用户仍可在本地继续编辑，待连接恢复后再将积压的操作合并上传。这种离线友好的设计极大提升了系统的容错能力。

除了基础绘图同步，Excalidraw 还巧妙地利用这条长连接实现了丰富的协作感知功能。例如：

• 实时显示他人光标位置和选中状态，让你知道谁正在关注哪一部分；
• 高亮正在编辑的文字框，防止多人同时修改造成覆盖；
• 支持端到端加密（E2EE），确保敏感架构图不会被中间代理窃取。

这些细节共同营造出一种“共处一室”的临场感，远超传统截图+文字描述的沟通效率。

值得一提的是，随着 AI 功能的集成，这条 WebSocket 通道的价值进一步放大。现在用户可以直接输入自然语言指令，如“画一个包含网关、用户服务和订单服务的微服务架构图”，系统便会调用后端 NLP 模型生成对应的图形元素数组：

async function generateDiagramFromPrompt(prompt, roomId) { const response = await fetch('/api/ai/generate-diagram', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ prompt }) }); const { elements } = await response.json(); addToCurrentScene(elements); socket.send(JSON.stringify({ type: 'ai-generated-elements', elements, roomId, timestamp: Date.now() })); }

AI 生成的结果不再是孤立输出，而是作为普通更新事件注入协作流，立即推送给所有参与者。这意味着整个团队可以围绕 AI 输出快速展开迭代，形成“提示 → 生成 → 讨论 → 修改”的闭环。这种智能增强型协作模式，正是下一代生产力工具的核心方向。

从系统架构上看，Excalidraw 的协作体系呈现出清晰的分层结构：

graph TD A[Client A] -->|WebSocket| B[WebSocket Server] C[Client B] -->|WebSocket| B D[Client C] -->|WebSocket| B B --> E[Room Manager] B --> F[State Sync Engine] F --> G[(Redis/Firestore)] H[AI Service] -->|REST/gRPC| B

• 客户端负责交互捕捉与本地渲染；
• WebSocket 服务端维持连接、转发消息；
• 状态引擎处理冲突、保障一致性；
• 存储层缓存快照，支持历史回溯；
• AI 微服务独立部署，按需调用。

这种松耦合设计使得各组件可独立扩展。例如，在高并发场景下，可通过横向扩展 WebSocket 实例配合 Redis Pub/Sub 实现集群化；AI 模块也可根据负载动态伸缩，不影响主流程稳定性。

在工程实践中，几个关键设计考量决定了系统的健壮性：

• 心跳保活：定期发送 ping/pong 消息防止 NAT 超时断连；
• 消息排序：为每条更新附加时间戳或逻辑时钟，避免乱序导致状态错乱；
• 增量同步：只传输 diff 数据而非全量状态，显著降低带宽消耗；
• 降级策略：当 WebSocket 不可用时（如某些企业防火墙限制），自动回落至 SSE 或长轮询；
• 权限控制：区分编辑者与观察者角色，保护核心内容不被误改；
• 操作审计：记录关键事件日志，便于事后追溯与合规审查。

这些看似琐碎的细节，恰恰是产品能否在真实网络环境中稳定运行的关键。

回到最初的问题：为什么是 WebSocket？因为它真正实现了从“被动拉取”到“主动推送”的范式转变。对于 Excalidraw 这类强调即时反馈的协作工具而言，每一次毫秒级的延迟缩减，都是用户体验的质变。

更重要的是，这种技术选择反映了一种设计理念：把沟通成本降到最低。无论是程序员画架构图、产品经理勾勒原型，还是教师讲解算法逻辑，最理想的工具应该让人专注于“表达思想”本身，而不是纠结于“怎么让别人看到”。

如今，Excalidraw 已不仅是开源社区中的明星项目，更被许多企业用于私有化部署，成为内部知识协作的标准组件。它的成功说明了一个趋势：未来的办公软件不再只是功能堆砌，而是要在实时性、安全性与智能化之间找到平衡点。

而 WebSocket 所代表的长连接通信能力，正是这场变革的基础设施之一。它不像 AI 那样引人注目，却像水电一样默默支撑着每一次流畅的协作体验。或许多年以后我们会发现，正是这些底层协议的普及，才真正开启了分布式团队高效共创的新时代。