C# WebSocket 的优雅关闭（详解 WebSocket 关闭握手处理）

什么是 WebSocket 关闭握手？

WebSocket 协议规定，当任意一端（客户端或服务端）希望关闭连接时，必须发送一个 Close 帧。接收方收到后，应回复一个 Close 帧作为确认，这个双向交互过程就称为“关闭握手”（Close Handshake）。

如果跳过这个步骤直接断开 TCP 连接，可能会导致数据丢失、连接状态不一致等问题。因此，掌握 WebSocket 正确关闭连接 的方法是每个开发者必备技能。

C# 中如何实现 WebSocket 关闭握手？

在 .NET 中，我们可以使用 System.Net.WebSockets 命名空间下的 ClientWebSocket 类（客户端）或自定义服务端逻辑（如使用 ASP.NET Core 的 SignalR 或原生 WebSocket 支持）来处理 WebSocket 连接。

下面以客户端为例，展示如何优雅地完成 C# 实现 WebSocket 断开处理。

客户端关闭示例

using System;using System.Net.WebSockets;using System.Text;using System.Threading;using System.Threading.Tasks;class Program{    static async Task Main(string[] args)    {        var client = new ClientWebSocket();        try        {            // 连接到 WebSocket 服务器            await client.ConnectAsync(new Uri("wss://echo.websocket.org"), CancellationToken.None);            Console.WriteLine("已连接到 WebSocket 服务器。");            // 模拟发送/接收数据...            // ...            // === 正确关闭连接 ===            // 发送 Close 帧（状态码 1000 表示正常关闭）            await client.CloseOutputAsync(WebSocketCloseStatus.NormalClosure, "客户端主动关闭", CancellationToken.None);            // 等待服务器回复 Close 帧            var closeResult = await client.CloseAsync(WebSocketCloseStatus.NormalClosure, "客户端确认关闭", CancellationToken.None);            Console.WriteLine($"关闭完成，状态码：{closeResult.CloseStatus}, 描述：{closeResult.CloseStatusDescription}");        }        catch (Exception ex)        {            Console.WriteLine($"发生错误：{ex.Message}");        }        finally        {            // 确保资源被释放            client?.Dispose();        }    }}

注意：CloseOutputAsync 用于发送关闭请求，而 CloseAsync 会等待对方响应后再完成关闭。两者配合使用才能完成完整的 WebSocket Close Handshake 教程 所描述的流程。

常见错误与最佳实践

• 不要直接调用 Dispose() 而不进行关闭握手：这会导致连接被强制终止，可能丢失未处理的消息。
• 始终使用 CancellationToken：避免因网络问题导致程序卡死。
• 检查关闭状态码：标准状态码如 1000（正常）、1001（离开）、1006（异常断开）等，有助于调试问题。
• 在 finally 块中释放资源：确保即使发生异常，WebSocket 对象也能被正确释放。

总结

通过本文，你已经掌握了在 C# 中如何正确处理 WebSocket 的关闭握手。记住：优雅关闭不仅是协议要求，更是专业开发的体现。无论你是构建聊天应用、实时仪表盘还是游戏服务器，遵循 C# WebSocket 关闭握手 的最佳实践，都能让你的应用更加健壮可靠。

—— 完 ——