WebSocket租户隔离需将租户标识置于URL查询参数中，如?tenant_id=acme-inc；前端动态构造URL并确保租户上下文就绪后再连接，切换租户时须关闭旧连接；后端必须严格校验租户合法性。
WebSocket 连接本身不支持像 HTTP 那样在请求头中动态携带租户信息（如 Authorization 或自定义 header），所以前端必须把租户标识明确体现在 WebSocket URL 中，服务端再据此做租户隔离。关键在于：URL 是唯一可被浏览器原生 WebSocket API 读取并传递的上下文载体。
租户标识必须放在 WebSocket URL 路径或查询参数中
推荐使用查询参数方式，语义清晰、易读易调试，且服务端解析简单：
-
✅ 推荐写法：
ws://your-api.com/ws?tenant_id=acme-inc或wss://api.example.com/ws?org=shop-123 -
⚠️ 不建议路径嵌套：
ws://.../ws/acme-inc—— 容易与后端路由规则冲突，且对多级租户（如租户+子空间）扩展性差 -
? 禁止用 fragment（#）：
ws://.../ws#tenant=abc—— 浏览器不会将 fragment 发送给服务端
前端需在建立连接前可靠获取并注入租户标识
租户标识通常来自登录态、路由参数或本地缓存，务必确保它已就绪再创建 WebSocket 实例：
- 从当前用户登录凭证中提取，例如：
const tenantId = user.profile.tenant?.id || localStorage.getItem('current_tenant') - 若应用采用子域名租户（如
acme.yourapp.com），可用window.location.hostname.split('.')[0]提取 - 避免在未确认租户上下文时提前初始化 WebSocket —— 否则可能连错通道，导致消息错乱或权限越界
连接 URL 应支持运行时动态构造，不可硬编码
不要写死 URL 字符串，而是封装成工厂函数：
立即学习“Java免费学习笔记（深入）”；
function createTenantWebSocket(tenantId, baseUrl = 'wss://api.example.com') {
if (!tenantId) throw new Error('Missing tenant identifier');
const url = new URL('/ws', baseUrl);
url.searchParams.set('tenant_id', tenantId);
return new WebSocket(url.toString());
}
// 使用示例
const ws = createTenantWebSocket('acme-inc');
这样既便于测试（可传入 mock tenant），也方便后续集成 token、环境变量等其他参数。
注意跨租户连接复用与清理逻辑
一个页面可能切换租户（如管理员切换客户视图），此时必须主动关闭旧连接，避免多个 WebSocket 并存造成资源泄漏或消息混淆：
- 每次切换租户前调用
oldWs.close()，并监听onclose确保释放 - 可配合 React 的
useEffect或 Vue 的onUnmounted自动清理 - 不要试图复用同一 WebSocket 实例来“切换租户”——协议不支持运行时修改 URL
不复杂但容易忽略：租户隔离的前提是前端 URL 注入 + 后端严格校验，二者缺一不可。前端只管正确拼 URL，后端必须校验该 tenant_id 是否合法、是否授权访问当前会话。
