子应用不能各自new WebSocket,因会导致多连接资源浪费、卸载后连接残留、消息互相干扰、内存泄漏及无上下文隔离;必须由主应用统一管理单例连接并分发消息。

子应用直接 new WebSocket 会失败或连接错乱,必须由主应用统一管理连接、子应用只消费消息。
为什么子应用不能各自 new WebSocket
qiankun 的沙箱虽然放行了 WebSocket 构造函数(见 ./packages/sandbox/src/core/globals.ts),但每个子应用独立调用 new WebSocket(url) 会导致:
- 多个 TCP 连接并存,浪费资源且服务端难以区分来源
- 子应用刷新/卸载时未主动
close(),连接残留甚至触发onerror混淆 - 不同子应用监听同一事件却无上下文隔离,消息互相干扰(比如都监听
"user:update") - 沙箱内
addEventListener绑定的回调在子应用 unmount 后仍可能被触发,引发内存泄漏或报错Cannot read property 'xxx' of null
主应用统一管理 WebSocket 连接
主应用创建单例 WebSocketService,负责连接生命周期和基础路由分发:
- 连接建立后只维持一个
socket实例,所有子应用共享 - 暴露
on(event, cb)和emit(event, data)接口,内部按event名称做简单分发 - 在
socket.onmessage中解析服务端下发的{ type, payload, from }结构,避免裸字符串匹配 - 主应用监听
unmount钩子,在最后子应用卸载后才调用socket.close()
示例片段:
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。
class WebSocketService {
constructor() {
this.socket = null;
this.listeners = new Map();
}
connect(url) {
this.socket = new WebSocket(url);
this.socket.onmessage = (e) => {
const { type, payload } = JSON.parse(e.data);
// 分发给所有监听 type 的回调
this.listeners.get(type)?.forEach(cb => cb(payload));
};
}
on(type, cb) {
if (!this.listeners.has(type)) this.listeners.set(type, []);
this.listeners.get(type).push(cb);
}
off(type, cb) {
const cbs = this.listeners.get(type);
if (cbs) this.listeners.set(type, cbs.filter(f => f !== cb));
}
}
子应用如何安全订阅与发送
子应用不接触 WebSocket 实例,只通过主应用注入的 props 或全局 eventBus 通信:
- 主应用注册子应用时传入
props: { ws: websocketService },子应用在mount钩子中调用props.ws.on('chat:new', handler) - 务必在
unmount钩子中调用props.ws.off('chat:new', handler),否则 handler 会持续驻留内存 - 若用 mitt 做跨子应用广播,建议将 WebSocket 收到的消息再封装一层:主应用
emitter.emit('ws:message', { type, payload }),各子应用监听自己关心的type - 避免在子应用中把
handler写成箭头函数闭包引用组件实例——卸载后仍持引用,React/Vue 都会内存泄漏
跨子应用协作场景下的命名与权限收敛
当多个子应用需响应同一类实时事件(如协同编辑、通知中心),仅靠 type 字符串不够可靠:
- 服务端消息体必须带明确作用域字段,例如
{ type: "doc:change", scope: "app-doc-editor", docId: "abc123" } - 主应用
WebSocketService可增加白名单过滤逻辑:if (!allowedScopes.includes(msg.scope)) return - 子应用订阅时应传入自身标识:
props.ws.on('doc:change', handler, { scope: 'app-doc-editor' }),便于主应用做精准路由 - 禁止子应用直接
emit原始消息;所有上行消息必须经主应用校验(如 token、scope、schema)后再转发
真正难的不是连上 WebSocket,而是让十几个子应用在共享一条连接的前提下,彼此不越界、不误伤、不漏收——这要求主应用承担协议网关角色,而非简单透传。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










