python-socketio客户端连接服务器后阻塞无输出问题求助

核心问题分析 #

服务器已确认Python代理（Agent）成功建立连接，但Agent端的connect事件未触发、无法接收info消息且无任何输出，核心原因大概率是Socket.IO版本不兼容或命名空间事件绑定未正确关联。

解决方案步骤 #

1. 确保Socket.IO版本兼容 #

Node.js的socket.io服务器与Python的python-socketio客户端必须使用协议兼容的版本：

• 查看Node端版本：执行 npm list socket.io
• 查看Python端版本：执行 pip show python-socketio

版本对应关系：

• Node socket.io v4.x → Python python-socketio v4.x
• Node socket.io v3.x → Python python-socketio v3.x
• Node socket.io v2.x → Python python-socketio v2.x

若版本不匹配，升级/降级其中一方至兼容版本即可。

2. 修正Agent端的命名空间事件绑定 #

当前Agent代码的事件监听是全局的，未关联/agent命名空间，导致服务器的命名空间事件无法触发客户端回调。修改agent.py如下：

import socketio

sio = socketio.Client()

# 为/agent命名空间绑定connect事件
@sio.event(namespace='/agent')
def connect():
    print("I'm connected!")

@sio.event(namespace='/agent')
def connect_error(data):
    print("The connection failed!")

@sio.event(namespace='/agent')
def disconnect():
    print("I'm disconnected!")

# 为/agent命名空间绑定info事件
@sio.on('info', namespace='/agent')
def get_info():
    print("info request received by agent from server")

def main():
    sio.connect('http://localhost:3000', namespaces=['/agent'])
    sio.wait()

if __name__ == '__main__':
    main()

3. 启用调试日志排查细节 #

若修改后仍有问题，添加日志输出查看客户端连接的详细过程：

import socketio
import logging

# 启用调试日志
logging.basicConfig(level=logging.DEBUG)

sio = socketio.Client()

# ... 其余代码保持不变

关于sio.wait()的说明 #

sio.wait()是保持Socket.IO客户端运行并处理事件的正确方式，无需用自定义无限循环替代，它会阻塞主线程并持续监听服务器事件，完全适合需要长期运行的代理程序。

内容的提问来源于stack exchange，提问作者TZ5