C# WebSocket实战：5分钟搞定实时聊天应用（附完整源码）

C# WebSocket实战5分钟构建高可靠实时聊天系统实时通信已成为现代应用的核心需求之一。想象一下当用户发送消息时对方能立即看到当股票价格波动时交易界面实时更新当多人协作编辑文档时所有改动即时同步——这些场景都离不开WebSocket技术。本文将带你从零开始用C#构建一个具备生产级可靠性的实时聊天系统。1. WebSocket核心概念与优势WebSocket协议在2011年成为国际标准RFC 6455它解决了HTTP协议在实时通信领域的根本性缺陷。传统HTTP通信就像打电话——每次交流都需要重新拨号而WebSocket则像保持通话状态的对讲机。关键优势对比特性WebSocketHTTP轮询连接方式单次TCP连接持久化每次请求新建连接延迟毫秒级取决于轮询间隔(通常≥1秒)带宽消耗仅消息体少量帧头每次携带完整HTTP头通信方向全双工半双工服务器推送能力原生支持需要hack实现(如长轮询)在C#生态中System.Net.WebSockets命名空间提供了原生支持。最新.NET 8进一步优化了以下方面HTTP/2 WebSocket支持RFC 8441改进的压缩算法RFC 7692增强的心跳检测机制KeepAlive2. 五分钟快速实现2.1 服务端搭建首先创建ASP.NET Core空项目添加WebSocket中间件// Program.cs var builder WebApplication.CreateBuilder(args); var app builder.Build(); app.UseWebSockets(new WebSocketOptions { KeepAliveInterval TimeSpan.FromSeconds(30), ReceiveBufferSize 4 * 1024 }); var connections new ConcurrentDictionarystring, WebSocket(); app.Map(/ws, async context { if (context.WebSockets.IsWebSocketRequest) { var ws await context.WebSockets.AcceptWebSocketAsync(); var connId Guid.NewGuid().ToString(); connections.TryAdd(connId, ws); await HandleMessages(ws, connId, connections); } else { context.Response.StatusCode 400; } }); async Task HandleMessages(WebSocket ws, string connId, ConcurrentDictionarystring, WebSocket connections) { var buffer new byte[1024 * 4]; try { while (ws.State WebSocketState.Open) { var result await ws.ReceiveAsync(new ArraySegmentbyte(buffer), CancellationToken.None); if (result.MessageType WebSocketMessageType.Text) { var message Encoding.UTF8.GetString(buffer, 0, result.Count); await BroadcastMessage(${connId}: {message}, connections); } else if (result.MessageType WebSocketMessageType.Close) { await ws.CloseAsync(WebSocketCloseStatus.NormalClosure, null, CancellationToken.None); connections.TryRemove(connId, out _); } } } catch { connections.TryRemove(connId, out _); await ws.CloseAsync(WebSocketCloseStatus.InternalServerError, null, CancellationToken.None); } } async Task BroadcastMessage(string message, ConcurrentDictionarystring, WebSocket connections) { var buffer Encoding.UTF8.GetBytes(message); foreach (var (_, ws) in connections) { if (ws.State WebSocketState.Open) { await ws.SendAsync(new ArraySegmentbyte(buffer), WebSocketMessageType.Text, true, CancellationToken.None); } } } app.Run();2.2 客户端实现创建控制台客户端项目using System.Net.WebSockets; var ws new ClientWebSocket(); await ws.ConnectAsync(new Uri(ws://localhost:5000/ws), CancellationToken.None); // 接收消息线程 _ Task.Run(async () { var buffer new byte[1024 * 4]; while (true) { var result await ws.ReceiveAsync(new ArraySegmentbyte(buffer), CancellationToken.None); if (result.MessageType WebSocketMessageType.Text) { Console.WriteLine($收到: {Encoding.UTF8.GetString(buffer, 0, result.Count)}); } else if (result.MessageType WebSocketMessageType.Close) { break; } } }); // 发送消息 while (true) { var input Console.ReadLine(); if (string.IsNullOrEmpty(input)) continue; var bytes Encoding.UTF8.GetBytes(input); await ws.SendAsync(new ArraySegmentbyte(bytes), WebSocketMessageType.Text, true, CancellationToken.None); }3. 生产级优化策略3.1 心跳检测机制防止因网络问题导致僵尸连接// 服务端配置 app.UseWebSockets(new WebSocketOptions { KeepAliveInterval TimeSpan.FromSeconds(10), KeepAliveTimeout TimeSpan.FromSeconds(5) // .NET 9新增 }); // 客户端配置 ws.Options.KeepAliveInterval TimeSpan.FromSeconds(10); ws.Options.KeepAliveTimeout TimeSpan.FromSeconds(5);3.2 消息压缩减少带宽消耗注意安全风险ws.Options.DangerousDeflateOptions new WebSocketDeflateOptions { ClientMaxWindowBits 10, ServerMaxWindowBits 10, DisableCompression false // 敏感数据应设为true };3.3 安全加固// 限制消息大小 app.UseWebSockets(new WebSocketOptions { ReceiveBufferSize 4 * 1024, // 4KB AllowedOrigins { https://yourdomain.com } }); // 添加认证 app.Map(/ws, async context { if (!context.User.Identity?.IsAuthenticated ?? false) { context.Response.StatusCode 401; return; } // ...其余代码 });4. 高级功能实现4.1 二进制消息传输// 发送图片示例 var imageBytes await File.ReadAllBytesAsync(photo.jpg); await ws.SendAsync(new ArraySegmentbyte(imageBytes), WebSocketMessageType.Binary, true, CancellationToken.None); // 接收处理 if (result.MessageType WebSocketMessageType.Binary) { await File.WriteAllBytesAsync($received_{DateTime.Now.Ticks}.jpg, buffer[..result.Count]); }4.2 房间分组广播// 使用ConcurrentDictionary管理房间 var rooms new ConcurrentDictionarystring, ListWebSocket(); // 加入房间 rooms.AddOrUpdate(room1, new ListWebSocket { ws }, (_, list) { list.Add(ws); return list; }); // 房间广播 foreach (var socket in rooms[room1]) { if (socket.State WebSocketState.Open) { await socket.SendAsync(/*...*/); } }4.3 性能监控指标// 添加指标收集 var metrics new WebSocketMetrics(); app.Use(async (context, next) { var stopwatch Stopwatch.StartNew(); await next(); stopwatch.Stop(); metrics.LogConnectionDuration(stopwatch.Elapsed); }); class WebSocketMetrics { private long _totalMessages; private long _activeConnections; public void LogMessage() Interlocked.Increment(ref _totalMessages); public void LogConnection() Interlocked.Increment(ref _activeConnections); public void LogDisconnection() Interlocked.Decrement(ref _activeConnections); }5. 故障排查与调试常见问题解决方案连接立即断开检查服务端AcceptWebSocketAsync是否在中间件中正确调用验证CORS配置如需跨域大消息传输失败调整ReceiveBufferSize默认4KB分片处理多帧消息while (!result.EndOfMessage) { result await ws.ReceiveAsync(/*...*/); // 拼接buffer... }内存泄漏预防确保所有连接最终从集合中移除实现IDisposable正确释放资源// 连接清理示例 finally { connections.TryRemove(connId, out _); ws.Dispose(); }调试工具推荐Wireshark过滤websocket协议Chrome开发者工具中的WebSocket帧检查ASP.NET Core的日志系统设置LogLevel.WebSockets为Debug通过本文的实践你不仅掌握了WebSocket的基础用法还了解了生产环境所需的各项优化措施。在实际项目中建议结合SignalR等高级库简化开发它们内置了这些最佳实践。