Python asyncio REPL与普通REPL中websockets连接超时问题排查

核心差异点 #

两种环境的关键区别在于事件循环的初始化逻辑和SSL上下文的默认配置：

1. asyncio REPL的默认配置 #

python -m asyncio启动的REPL会初始化一个长期运行的事件循环，启动过程中会自动加载系统默认的SSL上下文配置。当你导入ssl模块后，这个上下文会被websockets的connect函数隐式调用，确保WSS连接的SSL握手流程正常完成。

2. 普通环境（脚本/常规REPL）的事件循环 #

asyncio.run()会创建一个全新的临时事件循环，任务完成后立即关闭。这种场景下：

• websockets的connect函数若未显式指定ssl参数，会使用简化的默认SSL配置，可能导致证书验证或握手过程超时；
• 临时循环没有预加载系统证书缓存，SSL握手的耗时容易超过websockets默认的10秒超时阈值，从而触发TimeoutError。

验证与解决方案 #

显式指定SSL上下文 #

在普通环境中，显式传递系统默认的SSL上下文给connect函数，即可解决超时问题：

import asyncio
import websockets.client as wsc
import ssl

wss_url = "你的WSS地址"

async def main():
    # 显式创建系统默认SSL上下文
    ssl_context = ssl.create_default_context()
    async with wsc.connect(wss_url, ssl=ssl_context) as ws:
        print("Connected: websocket")
        await ws.send('data')

if __name__ == '__main__':
    asyncio.run(main())

调整超时参数 #

如果SSL握手确实较慢，可以通过timeout参数延长超时时间：

async with wsc.connect(wss_url, ssl=ssl_context, timeout=30) as ws:
    # 后续逻辑

为什么asyncio REPL不导入ssl会出错？ #

websockets连接WSS必须依赖SSL上下文，asyncio REPL在未导入ssl模块时，无法获取系统默认的SSL上下文配置，导致握手失败，表现出类似超时的错误。导入ssl后，REPL的事件循环能正确加载上下文，因此连接成功。

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