讲师中心 微信公众号
AI工具推荐 视频效率加速

WebSocket多客户端区分方法 WebSocket前端如何标识用户标识【技巧】

轻雪吖_6953

轻雪吖_6953

发布时间:2026-06-03 17:31:59

|

646人浏览过

|

来源于php中文网

原创

WebSocket连接时需显式传递user_id,推荐路径参数(如/ws/1001)最轻量可靠;查询参数适合透传临时token;首条消息最灵活但多一次往返且需防超时。

websocket多客户端区分方法 websocket前端如何标识用户标识【技巧】

后端无法自动知道你是谁,必须由前端主动传递用户标识,且要确保每次连接都带得上、接得住、不丢失。

WebSocket 连接时怎么传 user_id?

不能依赖 Cookie 或 Session 自动携带(尤其跨域或非浏览器环境),必须显式传。常见方式有三种:

  • URL 路径参数:如 ws://api.example.com/ws/1001,后端用 @app.websocket("/ws/{user_id}") 拿到 user_id
  • 查询参数:如 ws://api.example.com/ws?user_id=1001&token=abc,后端从 websocket.query_params.get("user_id") 读取
  • 连接后首条消息:先 await websocket.accept(),再 data = await websocket.receive_json(),要求前端发的首帧是 {"user_id": 1001, "token": "..."}

路径参数最轻量、最可靠;查询参数适合需透传 token 的场景;首条消息最灵活但多一次往返,且要防超时或空消息。

为什么 axios + WebSocket 会拿不到 session?

因为 WebSocket 握手请求(Upgrade: websocket)和普通 HTTP 请求走的是两套机制,axios 的 withCredentials: true 对 WebSocket 无效——它只影响后续的 fetch 或 XMLHttpRequest。

立即学习“前端免费学习笔记(深入)”;

前端设计优化skill
前端设计优化skill

前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。

下载
  • 前端别指望靠 document.cookie 或 session 自动绑定 WebSocket 连接
  • Spring Boot 中 HttpSessionHandshakeInterceptor 能取到 session,但前提是握手请求同域 + 同 session ID + 浏览器未禁用 third-party cookie
  • Vue 项目若用 axios 登录后立刻连 ws,大概率 session ID 不一致,导致 session.getAttribute("USER_INFO") 为 null

解决办法只有一个:把登录后拿到的 user_id 或 token 存进 localStorage 或 ref,再拼进 WebSocket URL。

FastAPI / Node.js / Spring Boot 怎么存 client 映射?

拿到 user_id 后,得把它和当前 WebSocket 实例绑定,否则发消息时找不到人。关键不是“怎么存”,而是“怎么保证线程/进程安全”:

  • FastAPI 单进程:用 dict 或 ConcurrentDict(如 anyio.StrictFIFOLock 包裹写操作)
  • Node.js:Map 足够,但注意 webSocket.on("close") 里必须 delete 对应项,否则内存泄漏
  • Spring Boot 多实例部署时:不能只用本地 ConcurrentHashMap,得上 Redis + Pub/Sub 或分布式锁,否则 A 服务存了 user_id,B 服务收不到广播

别直接用 websocket.client_address 当标识——IP 可能复用(NAT)、可能变(移动网络)、无法区分同一设备多个标签页。

JWT token 放 URL 查询参数安全吗?

不安全,但比不验证强一点。问题在于:

  • URL 会被浏览器历史、代理日志、CDN 缓存记录,token 泄露风险高
  • 长度受限(部分服务器截断长 URL),且无法刷新
  • 正确做法:用查询参数传一个短期有效的 connect_token(由后端签发,5 分钟过期),握手成功后再用该 token 换正式 JWT 或绑定 session

真正敏感的业务(如金融指令),应该在首条消息里用加密 payload 传输用户凭证,并做签名验签——URL 里只放无状态的临时票据。

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2523

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5463

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6490

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6118

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

863

2024.05.22

C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

3229

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2328

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

1260

2023.08.02

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

40

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebSocket手册
WebSocket手册

共0课时 | 0人学习

Webman中文手册
Webman中文手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn