websocket连接wss失败主因是ssl证书验证严格，需用sslopt={"cert_reqs": ssl.cert_none}临时绕过；收不到消息因未调用run_forever()或未正确注册on_message回调；数据乱码因默认接收bytes需decode；断连不重连需手动在on_close中处理。
WebSocket 连接 WSS 失败：证书验证报错 ssl.SSLCertVerificationError
默认情况下 websocket-client 会严格校验服务器 TLS 证书，WSS 连接私有部署或自签名证书的服务时直接抛错。这不是连接逻辑问题，而是 SSL 层拦截。
- 临时绕过（仅开发/测试）：传入
sslopt={"cert_reqs": ssl.CERT_NONE}，同时确保导入ssl模块 - 生产环境必须用有效证书，或把根证书加到系统信任链；不要在代码里硬写
CERT_NONE - 注意：Python 3.12+ 对
ssl.CERT_NONE有更严格警告，部分发行版甚至默认禁用
接收消息卡住或收不到推送：没启动 run_forever() 或漏了回调注册
websocket-client 是事件驱动模型，不是发个请求就返回结果。不主动维持长连接、不注册回调，连接建立后立刻静默退出。
- 必须调用
ws.run_forever()启动事件循环，否则连接握手完就断开 -
on_message回调函数需在WebSocket实例创建后、run_forever()前注册，顺序错了等于没设 - 如果需要同步收一条就停，改用
ws.recv()配合timeout参数，但注意它会阻塞，且不适用于持续推送场景
数据乱码或 JSON 解析失败：收到的是 bytes 不是 str
WebSocket 协议本身不规定 payload 编码，websocket-client 默认以 bytes 形式传给 on_message，直接 json.loads() 必然报 TypeError: expected string or bytes-like object。
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 检查
msg类型：isinstance(msg, bytes)，是的话先用msg.decode("utf-8") - 有些服务端发的是二进制帧（比如 protobuf），此时不能硬 decode，得看文档确认格式
- 别依赖
websocket.enableTrace(True)输出来判断内容编码——trace 日志里显示的可能是经过转义的字符串，和实际回调参数类型不一致
连接意外中断后不重连：没处理 on_error 和 on_close
网络抖动、服务端重启、心跳超时都会触发断连，但 run_forever() 不会自动重试，也不会抛异常中断主线程，程序看似“活着”实则已失联。
- 在
on_close里调用ws.connect()+ws.run_forever()可实现简单重连，但要注意避免无限重连风暴 - 更稳妥的做法是用独立线程控制重试节奏，比如加
time.sleep(3)再重连，并限制最大重试次数 -
on_error回调里拿到的是原始异常对象，可据此区分是网络错误还是协议错误，决定是否重连
真正麻烦的从来不是连上 WSS，而是维持住它——心跳间隔、ping/pong 帧响应、消息粘包、反向代理的超时设置，这些都在 WebSocket 协议层之下悄悄起作用。别只盯着 Python 代码，先确认服务端的 WebSocket 文档有没有写明 ping 间隔和重连策略。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
