Python-SocketIO 中 aiohttp 3.9.0+ 版本导致断开连接事件丢失问题分析

问题背景

在使用 Python-SocketIO 库的异步服务器时，发现当 aiohttp 版本升级到 3.9.0 及以上时，服务器端的 disconnect 事件不再被触发。这个问题在 aiohttp 3.8.6 及以下版本中表现正常。

问题现象

当客户端与服务器建立 WebSocket 连接后主动断开时：

• 在 aiohttp 3.8.6 版本下，服务器能正常收到 disconnect 事件
• 在 aiohttp 3.9.0+ 版本下，服务器无法收到 disconnect 事件

根本原因

经过分析，这个问题源于 aiohttp 3.9.0 版本中的一个内部变更。具体来说：

1. 在 aiohttp 3.9.0 之前，WebSocket 关闭时的 _close_code 属性被设置为 None
2. 从 aiohttp 3.9.0 开始，该属性被改为默认返回 1000（正常关闭状态码）

这个看似微小的变化影响了 Python-SocketIO 对连接状态的判断逻辑，导致断开连接事件无法正确触发。

解决方案

在实际测试中发现，当使用 aiohttp 的标准运行方式（通过 aiohttp.web.Runner 和 aiohttp.web.TCPServer）时，这个问题不会出现。问题主要出现在使用 aiohttp.test_utils.TestServer 进行测试的场景中。

因此，推荐的解决方案是：

1. 在生产环境中，确保使用标准的 aiohttp 服务器启动方式
2. 在测试环境中，可以考虑：
   • 降级到 aiohttp 3.8.6
   • 修改测试代码，使用标准服务器启动方式替代 TestServer
   • 等待 Python-SocketIO 针对新版本 aiohttp 的适配更新

技术启示

这个案例展示了底层库的微小变更可能对上层应用产生意想不到的影响。作为开发者，我们需要：

1. 密切关注依赖库的版本更新和变更日志
2. 在升级关键依赖时进行充分的回归测试
3. 理解底层库的工作原理，以便快速定位类似问题

对于 WebSocket 实现这类底层通信组件，状态码和处理流程的变化往往会影响整个应用的行为，需要特别小心对待。