MLAPI项目中WebGL客户端非正常断开导致服务器拒绝新连接问题解析

问题背景

在基于MLAPI框架开发的WebGL多人游戏中，开发人员发现了一个严重影响游戏体验的问题：当最后一个玩家（或唯一玩家）通过直接关闭浏览器的方式非正常断开连接时，服务器会进入一种异常状态，导致无法接受新的客户端连接。这个问题在WebGL游戏场景中尤为关键，因为浏览器关闭是玩家常见的退出方式。

问题现象

服务器在以下特定场景会出现连接异常：

1. 当使用WebGL构建的客户端作为第一个/唯一玩家加入游戏
2. 该玩家通过直接关闭浏览器的方式非正常断开连接
3. 服务器在30秒超时后才会真正断开该玩家
4. 在这30秒窗口期内及之后，新客户端尝试连接都会失败

值得注意的是，如果玩家通过游戏内的"返回主菜单"按钮正常退出，则不会触发此问题。

技术分析

经过深入排查，发现问题根源在于服务器端的传输层配置不当。具体表现为：

1. 协议不匹配：服务器端错误地配置了WebSocket协议("wss")，而实际上专用服务器应该使用DTLS协议
2. 传输方式冲突：服务器启用了WebSocket选项，这与专用服务器的运行环境不兼容

解决方案

正确的服务器端配置应做以下调整：

// 修改RelayServerData的协议参数
RelayServerData relayServerData = new RelayServerData(allocation, "dtls");

// 确保禁用WebSocket选项
NetworkManager.Singleton.GetComponent<UnityTransport>().UseWebSockets = false;

这一修改确保了：

• 服务器使用适合专用服务器环境的DTLS协议
• 禁用不适用于专用服务器的WebSocket传输方式
• 保持与Relay服务的正常通信

深入理解

为什么原配置会导致问题

WebSocket协议设计用于浏览器环境，而专用服务器运行在Linux环境下，更适合使用DTLS协议。当服务器错误配置为WebSocket时：

1. 非正常断开无法被正确处理
2. 连接状态管理出现混乱
3. 服务器资源无法正确释放
4. 新连接被错误拒绝

心跳超时的影响

开发过程中曾尝试调整心跳超时(HeartbeatTimeoutMs)作为临时解决方案：

• 增大超时值可以暂时缓解问题，但会导致：
  • 服务器状态不一致
  • 角色识别错误（客户端被误认为主机）
  • 最终服务器崩溃

这证实了问题本质在于协议层的不匹配，而非简单的超时参数调整可以解决。

最佳实践建议

对于MLAPI项目中的网络配置：

1. 环境适配：明确区分客户端和服务器环境，使用适合各自环境的协议
2. 传输配置：
   • WebGL客户端：使用WebSocket
   • 专用服务器：使用DTLS
3. 异常处理：实现完善的连接状态监控和异常恢复机制
4. 测试覆盖：特别关注非正常断开场景的测试

总结

这个案例展示了网络协议配置在多人游戏开发中的重要性。正确的协议选择不仅影响功能实现，更关系到系统的稳定性和可靠性。通过将服务器端协议调整为DTLS并禁用WebSocket选项，从根本上解决了非正常断开导致的连接问题，为WebGL多人游戏提供了稳定的服务器环境。