WebSocket不直接支持文件上传，应采用“HTTP上传+WebSocket推送”混合方案：前端用HTTP传文件并携带uploadId，后端关联WebSocket会话实时推送进度。
需要明确的是，WebSocket协议本身并不直接支持文件上传功能。它主要设计为全双工通信通道，擅长于实时消息传递，而非处理文件数据流。那么，在需要实现大文件上传并实时反馈进度的场景下，应该如何设计？最佳实践是采用一种混合架构：前端通过传统的HTTP协议（例如使用multipart/form-data或分片上传技术）上传文件数据，而后端在处理文件的同时，利用已建立的WebSocket连接，主动、实时地向特定客户端推送上传进度信息。这种方案结合了两种协议的优势，既保证了文件传输的可靠性，又实现了进度反馈的即时性。
为什么不能只靠 WebSocket 传大文件？
你可能会疑惑，既然WebSocket支持双向通信，为何不直接用它来传输文件呢？这背后有几个关键的技术限制。首先，WebSocket协议规范并未定义文件传输的语义，它缺少像HTTP协议那样对分块传输编码、断点续传、MIME类型识别的原生支持。其次，浏览器端的FormData对象无法直接通过WebSocket发送。虽然从技术上讲，你可以手动读取File对象，将其分片并通过WebSocket发送，但这需要开发者自行实现数据完整性校验、分片顺序控制、错误重传等复杂机制，开发成本极高且稳定性难以保障。因此，在真实的项目开发中，“HTTP负责上传 + WebSocket负责推送”的混合模式，成为了更高效、更可靠的主流解决方案。
前后端协作的关键设计
该方案的核心设计思路非常清晰：前端在上传请求中附带一个唯一标识符（例如uploadId），后端在处理该上传任务时，将此ID与当前用户的WebSocket会话进行关联绑定。在上传处理过程中，服务端定期计算进度百分比，并通过已关联的WebSocket连接，向对应的客户端推送结构化的JSON格式进度消息。
- 前端实现要点：使用
fetchAPI或XMLHttpRequest发起文件上传的HTTP请求。同时，在页面中建立并维持一个独立的WebSocket长连接（在连接URL中可携带用户Token或预先生成的uploadId用于身份识别）。 - 后端实现要点（以Node.js/Express + ws库为例）：在接收到HTTP上传请求时，生成唯一的uploadId并存储于内存Map或Redis等缓存中。启动文件写入或解析流程，在此过程中定时更新该uploadId对应的进度状态。最关键的一步是，通过WebSocket服务器实例，查找与该uploadId绑定的客户端连接，然后主动推送如
{"type":"progress","uploadId":"xxx","percent":65,"loaded":65536,"total":100000}这样的详细进度消息。 - 会话关联逻辑：如何建立上传任务与WebSocket会话的关联？一个常见的做法是，在WebSocket连接成功建立后，前端立即发送一条绑定指令消息，例如
{"action":"bind","uploadId":"xxx"}。后端收到此消息后，便将这个WebSocket会话对象与指定的uploadId建立映射关系，并缓存起来，为后续的定向推送做好准备。
注意上传过程中的状态一致性
大文件上传往往耗时较长，可能持续数分钟甚至更久，因此必须周密考虑网络中断、重复绑定、资源清理等一系列状态一致性问题：
立即学习“前端免费学习笔记（深入）”；
- 连接异常处理：当WebSocket连接意外断开时，后端应及时清理该连接对应的uploadId绑定关系，避免产生僵尸数据，防止后续进度消息误推或找不到目标客户端。
- 任务终态通知：上传任务无论是成功完成还是中途失败，后端都应通过WebSocket推送最终的状态消息，例如
{"type":"done","uploadId":"xxx","status":"success","url":"/files/xxx"}或{"type":"error","uploadId":"xxx","msg":"磁盘空间不足"}。前端据此可以更新UI并停止进度监听。 - 资源生命周期管理：建议为每个uploadId设置一个生存时间（TTL，例如30分钟），超过时限后自动清理相关的进度状态和缓存数据，这是防止服务端内存泄漏的有效手段。
- 分布式部署考量：如果需要部署多实例的后端服务，WebSocket的会话绑定关系必须存储到Redis这类共享的中间件中，而不能仅存放在单个进程的内存里。只有这样，才能确保任何一个服务实例都能找到正确的连接进行跨实例推送。
替代方案：使用 Server-Sent Events（SSE）更轻量？
那么，是否存在更轻量级的替代方案呢？如果业务场景只需要服务端向客户端的单向进度推送（无需客户端向服务端发送指令），并且对浏览器兼容性要求不高（例如不需要支持旧版IE），那么Server-Sent Events（SSE）技术是一个更简洁优雅的选择。SSE基于标准的HTTP长连接，天然支持自动重连和事件流解析，前端无需额外维护复杂的WebSocket连接对象。然而，如果业务中已经广泛使用了WebSocket（例如除了上传进度，还需要实时通知文件处理结果、支持在线聊天或协同编辑等功能），那么继续复用现有的WebSocket通道来实现进度推送，在系统架构上会更加统一，也利于代码维护。
