Mirror网络库中客户端断开连接时的KeyNotFoundException问题分析

问题背景

在使用Mirror网络库(版本81.4.0)进行多人游戏开发时，开发者发现当客户端断开连接时，无论是通过Alt+F4强制关闭还是调用conn.Disconnect()方法，服务器端都会抛出KeyNotFoundException异常。这个异常会导致后续新客户端无法连接到服务器，严重影响游戏的正常运行。

问题复现条件

该问题在以下环境中可以稳定复现：

• 操作系统：Windows
• 构建目标：WebGL和Windows平台
• Unity版本：2021.3.18f
• Mirror版本：81.4.0主分支
• 必须使用Multiplexer传输设置，普通的传输方式不会出现此问题

问题表现

当客户端断开连接时，服务器端会抛出如下异常：

KeyNotFoundException: The given key was not present in the dictionary.

这个异常导致服务器无法正确处理后续的连接请求，新客户端无法成功连接到服务器。从技术角度来看，这是一个典型的字典键查找失败问题，表明服务器在尝试访问某个连接相关的数据结构时，未能找到预期的键值。

问题根源分析

经过深入分析，这个问题源于Mirror网络库在处理客户端断开连接时的逻辑缺陷。具体来说：

1. 当使用Multiplexer传输时，Mirror内部维护了一个连接映射表
2. 客户端断开连接时，服务器尝试从映射表中移除该连接
3. 但在某些情况下，移除操作可能在连接已经完全清理后才执行
4. 导致后续尝试访问已不存在的连接时抛出KeyNotFoundException

解决方案

开发团队已经通过Pull Request #3723修复了这个问题。修复方案主要包括：

1. 改进了连接断开时的清理顺序
2. 增加了对连接状态的检查
3. 确保在尝试访问连接映射表前连接仍然有效
4. 添加了更健壮的异常处理机制

对开发者的建议

对于遇到类似问题的开发者，建议：

1. 及时更新到包含此修复的Mirror版本
2. 如果暂时无法升级，可以在自己的代码中添加try-catch块捕获KeyNotFoundException
3. 在客户端断开连接时，确保先完成所有网络操作再执行断开逻辑
4. 定期检查Mirror的更新日志，获取最新的稳定性改进

总结

这个问题的解决体现了Mirror网络库开发团队对稳定性的持续改进。对于使用Mirror进行多人游戏开发的团队来说，理解这类底层网络问题的根源和解决方案，有助于在开发过程中更好地处理网络连接相关的问题，提升游戏的稳定性和用户体验。