OSX系统下pip安装websocket-client报错及相关问题解决求助

阿华AIGC实验室

2026-5-26

解决websocket-client安装错误及发送消息时的'NoneType'属性错误

首先，针对你遇到的两个问题——安装websocket-client失败，以及发送消息时的'NoneType' object has no attribute 'connected'错误，我会一步步帮你解决：

一、解决websocket-client的安装错误

安装时出现大量错误，通常是pip版本过旧、网络问题或系统依赖缺失导致的，试试下面的方法：

先升级pip到最新版本
旧版本的pip可能存在兼容性问题，先执行：
```
python -m pip install --upgrade pip
```
检查Python版本兼容性
websocket-client要求Python 3.7及以上版本，先确认你的Python版本：
```
python --version
```
如果版本低于3.7，建议升级Python后再尝试安装。
安装系统依赖（针对Linux/macOS）
如果是Linux系统，编译某些依赖包需要Python开发工具，执行对应系统的命令：
- Debian/Ubuntu：
```
sudo apt-get update && sudo apt-get install python3-dev
```
- CentOS/RHEL：
```
sudo yum install python3-devel
```
macOS用户可能需要先安装Xcode Command Line Tools：
```
xcode-select --install
```
使用国内PyPI镜像源加速安装
网络超时是安装失败的常见原因，用国内镜像源可以解决：
```
pip install websocket-client -i https://pypi.tuna.tsinghua.edu.cn/simple
```
手动下载wheel包安装
如果上述方法都不行，直接下载对应系统和Python版本的wheel包（.whl）到本地，然后安装：
比如Python 3.10、64位Windows系统，下载websocket_client-1.6.4-py3-none-any.whl（版本号以最新为准），然后执行：
```
pip install websocket_client-1.6.4-py3-none-any.whl
```

二、解决发送消息时的`'NoneType' object has no attribute 'connected'`错误

这个错误通常是因为你没有正确初始化WebSocket客户端对象，或者误用了websockets库的API来调用websocket-client。下面是websocket-client的两种正确用法示例：

方式1：异步回调模式（推荐）

import websocket
import _thread
import time

# 定义回调函数
def on_message(ws, message):
    print(f"收到消息：{message}")

def on_error(ws, error):
    print(f"错误：{error}")

def on_close(ws):
    print("连接已关闭")

def on_open(ws):
    # 连接成功后发送消息
    def send_msg():
        time.sleep(1)
        ws.send("Hello from websocket-client!")
        time.sleep(1)
        ws.close()
    _thread.start_new_thread(send_msg, ())

if __name__ == "__main__":
    # 初始化WebSocketApp对象
    ws = websocket.WebSocketApp(
        "ws://你的服务器地址",
        on_open=on_open,
        on_message=on_message,
        on_error=on_error,
        on_close=on_close
    )
    # 启动连接
    ws.run_forever()

方式2：同步阻塞模式

from websocket import create_connection

try:
    # 创建连接
    ws = create_connection("ws://你的服务器地址")
    print("连接成功，发送消息...")
    ws.send("Hello from websocket-client!")
    # 接收返回消息
    response = ws.recv()
    print(f"收到响应：{response}")
finally:
    ws.close()

错误的常见原因：