uvicorn 0.50.0 调整了 websocket 实现的自动选择逻辑：只要环境里安装了 websockets-sansio，用 --ws auto 参数启动时就会优先调用这套实现。这次更新同时把之前基于 websockets 的旧实现标记为弃用，过渡期内可以用 --ws websockets 显式指定旧实现，最终运行的 websocket 服务路径，会受你安装的依赖、传入的启动参数共同影响。
来源：Uvicorn 官方更新记录
自动选择模式完全根据当前环境实际安装的可选包决定用哪套实现，所以开发机、容器、生产镜像如果装的依赖清单不一样，最终跑的 WebSocket 实现很可能也不一样。团队升级版本前最好先检查 requirements 文件或者 uv 锁文件里所有和 WebSocket 相关的依赖，在测试环境跑一遍把启动日志、握手协商结果都记录下来，别误以为本地能正常跑，所有部署镜像就一定会选同一个后端。
这次标记弃用，不代表旧实现直接在 0.50.0 版本里就被删掉了。官方留了 --ws websockets 这个显式配置，方便短期内要维持原有行为的项目过渡。但这只是临时兼容手段，项目维护者要多留意后续的更新公告，提前规划迁移，尤其要检查自定义 ping、压缩、关闭码、异常处理这些逻辑，有没有依赖旧实现的特殊行为。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
来源：Uvicorn 官方更新记录
做迁移测试的时候，要把普通连接、断线重连、大消息传输、心跳超时、服务关闭这些场景都覆盖到。如果服务前面挂了代理做转发，还要确认 Upgrade 请求头配置、空闲连接超时设置都符合要求。不同 WebSocket 实现的依赖版本、协议细节都可能有差异，哪怕你的 ASGI 业务代码完全没改，也要在真实的部署拓扑里重新复核运行效果。
这次更新的核心是改了默认选择策略，不是把应用层的 WebSocket API 整体重写。完全没用到 WebSocket 的服务，受改动的影响非常有限；平时默认用 --ws auto 参数启动的项目，只要环境里多装了可选包，就可能悄悄切换到新的后端。把依赖安装规则、启动参数、测试环境配置全部纳入版本管理，是直接控制这类隐式环境差异的最有效办法。
如果暂时要显式保留旧后端，一定要把这个过渡配置的依赖来源、后续迁移计划都记录清楚，纳入正式的启动参数管理，别只在本地开发命令里临时写。保证容器每次重建之后都能复现相同的实现选择，后面排查握手、连接关闭相关问题时，才有稳定的对照基准。
