简介这是一份采用MFC与CSocket编写的聊天室服务器端工程开发环境为VS2010适合正在学习MFC网络编程或者Socket通信的开发者。启动服务器端后可以接收多个客户端登录连接并承担消息转发中枢的角色使得多个客户端之间能够正常互聊。压缩包一共包含68个文件大小约27.74兆字节里面主要有源程序文件、头文件、对话框资源文件、编译产生的中间文件和调试信息同时附带一个可以直接运行的服务器端执行程序方便对比验证。目前已有683人学习使用。通过这份服务器端代码可以深入理解基于CSocket的监听连接、接收数据、转发消息等关键流程也能掌握使用消息机制或线程处理多客户端通信的思路再配合作者发布的客户端程序就能组成一套完整的局域网聊天室演示系统对课程设计或毕业设计都有实用价值。1. 项目整体设计与技术选型1.1 为什么选MFCCSocket搭建聊天室如果你玩过Windows桌面开发应该对MFC不陌生。这个框架虽然老但在企业级工具、上位机、内部通讯软件里依然有大量存量项目。CSocket是MFC对WinSock的封装最大的优势是能把网络事件通过消息机制分发给窗口写起来比裸用WinSock省心不少。我当初接这个聊天室程序的需求核心目标是做一个局域网内的多人文本聊天工具要求界面是Windows原生风格能部署在XP到Win10的老机器上不需要额外运行时。选型时对比过几种方案C#的WinForm上手快但目标机器不一定装了.NETQt功能强但项目里要引入一大套依赖最后选了MFCCSocket理由很直接微软自家的封装Win平台兼容性稳CSocket自带阻塞式收发和消息映射代码结构清晰适合快速交付。1.2 聊天室的整体架构与消息流转聊天室分服务端和客户端两个进程。服务端监听一个端口维护在线客户端列表负责把某个客户端发来的消息广播给其他所有客户端客户端连接服务端后既能发送消息也能接收服务端转发的他人消息。消息流转过程是这样的客户端A调用CSocket::Send发送一段文本服务端收到后用OnReceive进行异步通知在回调里调用Receive接收数据解析出消息体和来源ID然后遍历客户端列表把消息逐一转发给除A之外的其他客户端。整个数据流是典型的星型结构服务端是中心节点好处是客户端之间不用互连网络结构简单权限控制也方便。2. 核心类设计与接口封装2.1 服务端核心类CListenSocket与CClientSocket我用MFC的CSocket派生两个类CListenSocket负责监听和接受连接CClientSocket负责与每个客户端通信。先看监听类class CListenSocket : public CSocket { public: virtual void OnAccept(int nErrorCode); }; void CListenSocket::OnAccept(int nErrorCode) { if (nErrorCode ! 0) return; CClientSocket* pClient new CClientSocket(); if (Accept(*pClient)) { // 将新客户端加入列表并通知主窗口刷新在线人数 theApp.GetMainWnd()-PostMessage(WM_NEW_CLIENT, (WPARAM)pClient, 0); } else { delete pClient; } }关键点在于Accept之后必须用new创建CClientSocket对象并在客户端断开时delete它。如果你用栈对象函数结束连接就会被销毁通讯立刻中断。CClientSocket的核心是重写OnReceive和OnClose。OnReceive是异步通知告诉你有数据到了但不会告诉你数据长度需要自己循环接收直到缓冲区读空。服务端的CClientSocket还要负责转发所以要保存一个指向主窗口的指针以及当前客户端的ID。class CClientSocket : public CSocket { public: int m_nClientID; CWnd* m_pWnd; virtual void OnReceive(int nErrorCode); virtual void OnClose(int nErrorCode); }; void CClientSocket::OnReceive(int nErrorCode) { if (nErrorCode ! 0) return; // 循环读取直到没有数据 while (true) { char szBuf[1024] {0}; int nRead Receive(szBuf, 1023); if (nRead SOCKET_ERROR || nRead 0) break; // 把数据连同客户端ID发给主窗口处理 m_pWnd-PostMessage(WM_DISPATCH_MSG, (WPARAM)m_nClientID, (LPARAM)strdup(szBuf)); } }这里有个细节CSocket ^1 的Receive返回值0表示连接关闭SOCKET_ERROR表示出错。很多新手在OnReceive里只接收一次就退出结果客户端发来的长消息被截成几段所以要循环接收。2.2 客户端核心类CClientSocket与消息处理客户端相对简单只需要一个CClientSocket连接成功后把它的指针保存到对话框成员变量里。客户端同样重写OnReceive收到消息后把文本PostMessage到主窗口由主窗口负责显示在列表控件或编辑框里。客户端的Connect是阻塞式的如果服务器没启动或网络不通界面会卡死。解决办法是在连接前调用一下SetBlockingMode(FALSE)或者干脆把连接放到工作线程里。我个人习惯的做法是先设置非阻塞模式在OnConnect里根据错误码判断是否成功。但CSocket的Connect非阻塞模式有个坑连接成功会触发OnConnect回调失败时OnConnect的nErrorCode不等于0判断逻辑要写对。BOOL CClientSocket::ConnectServer(const CString strIP, UINT nPort) { SetBlockingMode(FALSE); // 先设非阻塞 Create(); BOOL bOK Connect(strIP, nPort); if (GetLastError() WSAEWOULDBLOCK) return TRUE; // 连接进行中等待OnConnect return FALSE; } void CClientSocket::OnConnect(int nErrorCode) { if (nErrorCode 0) { // 连接成功 m_pWnd-PostMessage(WM_NET_CONNECTED, 0, 0); } else { // 连接失败 m_pWnd-PostMessage(WM_NET_FAILED, 0, 0); } }这里GetLastError判断WSAEWOULDBLOCK是标准写法判断连接是否挂起。非阻塞模式在连接过程中会返回这个错误码属于正常现象。如果你看到返回TRUE就以为连接成功那就错了必须以OnConnect回调为准。3. 关键功能的实现细节3.1 界面布局与控件处理聊天室界面不需要花哨但有三个控件是刚需显示消息的列表框、输入消息的编辑框、发送按钮。我建议用CListBox显示消息设置行宽自动滚动这样消息多了不会卡界面比CRichEditCtrl轻量得多。为了让列表框自动滚到底部可以在添加消息后调用SetTopIndex(GetCount() - 1)。另外如果你要在列表里区分“自己发的”“别人发的”“系统提示”可以用不同的前缀或者干脆用不同颜色的字体。CListBox不支持按行设置颜色如果一定要颜色区分就得用CListCtrl或者重绘CListBox这里推荐一个简单方案消息文本统一拼接成[昵称] 内容格式视觉上已经够用。编辑框和按钮的处理有个易错点发送按钮点击后如果消息为空就直接Return避免发送空数据。收到的消息要经过编码转换下面细说。3.2 消息收发与字符串编码转换MFC里最常见的就是CString但CString默认是宽字符Unicode网络传输的是字节流所以发送前必须将CString转成UTF-8或GBK的char数组。我用的是UTF-8因为UTF-8兼容ASCII跨平台调试也不容易乱码。转换代码如下CStringA UTF8_CStringA(const CString str) { int nLen WideCharToMultiByte(CP_UTF8, 0, str, -1, NULL, 0, NULL, NULL); CStringA strA; char* pBuf strA.GetBuffer(nLen); WideCharToMultiByte(CP_UTF8, 0, str, -1, pBuf, nLen, NULL, NULL); strA.ReleaseBuffer(); return strA; } CString UTF8_ToCString(const char* pUTF8) { int nLen MultiByteToWideChar(CP_UTF8, 0, pUTF8, -1, NULL, 0); CString str; wchar_t* pBuf str.GetBuffer(nLen); MultiByteToWideChar(CP_UTF8, 0, pUTF8, -1, pBuf, nLen); str.ReleaseBuffer(); return str; }发送时先转换再Send接收时先Receive到char数组再转成CString显示。这个环节最大的坑是中文乱码。如果你的项目是Unicode字符集直接用(char*)str.GetBuffer()把宽字节塞进Send对方收到就是乱码甚至字符串截断。务必使用WideCharToMultiByte。3.3 粘包半包处理与协议设计TCP是流协议不像UDP有消息边界。假设你一次性Send了1000字节对方OnReceive可能收到全部也可能分两次收到各500字节反过来你两次Send对方可能一次性就收完了。这就是经典的粘包/半包问题。最简单的解决方案是自定义协议这里推荐“长度头消息体”的格式| 4字节长度网络字节序 | 消息体UTF-8字节 |每次Send之前把消息体长度放到前4个字节一起发送。接收端OnReceive时先把数据暂存到一个缓冲区解析出前4字节得到消息长度如果缓冲区里有完整的一条消息就把它切出来处理剩下的继续缓存。下面是我用的一个简易循环缓冲逻辑// 在CClientSocket里维护一个CByteArray m_arrBuffer // OnReceive中读取数据后调用这函数 void ProcessBufferedData() { while (m_arrBuffer.GetSize() 4) { // 取长度 unsigned int nLen 0; for (int i0; i4; i) { nLen (nLen 8) | (m_arrBuffer[i] 0xFF); // 大端序 } if (m_arrBuffer.GetSize() - 4 (int)nLen) break; // 数据不够等下一次接收 char* pMsg new char[nLen 1]; for (unsigned int i0; inLen; i) pMsg[i] m_arrBuffer[4 i]; pMsg[nLen] 0; CString strMsg UTF8_ToCString(pMsg); m_pWnd-PostMessage(WM_DISPATCH_MSG, (WPARAM)m_nClientID, (LPARAM)strMsg.Detach()); // 移除已处理部分 m_arrBuffer.RemoveAt(0, 4 nLen); delete[] pMsg; } }这个代码演示了如何处理TCP流虽然看着麻烦但聊天室一旦上人多了没有协议处理消息一定会错乱。很多初学者绕开这一块直接Receive一次当成一条消息结果是时好时坏百思不得其解。强烈建议从一开始就按“长度头消息体”来做。4. 实操中的坑与排查实录4.1 CSocket阻塞与界面卡死的解决方案CSocket在默认情况下是阻塞模式即Send和Receive如果没有完成会一直等待。在MFC的UI线程里如果某个操作阻塞超过几十毫秒界面就会假死。最常见的是服务端Accept后直接在那个线程里处理收数据一旦某个客户端连接后不发数据整个服务端就卡住了。我遇到过一次典型问题客户端连接后服务端对话框的OnReceive里调用Receive但客户端因为某种原因在收到数据前先断开服务端的Receive返回0按理说应该正常处理但当时我在OnReceive里加了个无限循环等待数据齐全结果界面直接无响应。后来我把所有耗时操作从UI线程剥离OnReceive只负责收原始数据然后PostMessage给主线程主线程里再处理协议解析和转发。这样界面只接收消息、刷新控件再也不会卡死。4.2 常见错误及调试技巧CSocket开发中我整理过几个出现频率极高的错误错误表现可能原因解决办法Create失败错误码10047地址族不匹配比如服务器IPv6监听客户端IPv4连接统一使用AF_INET创建时指定端口连接不上错误码10061服务端没启动或端口不对确认服务端Listen成功telnet测试端口Send返回错误WSAECONNRESET对方强制关闭连接比如崩溃退出服务端OnClose里清理客户端指针避免向已断开客户端继续Send中文乱码CString直接转char发送用WideCharToMultiByte转UTF-8消息时序错乱缺少协议处理添加长度头解析逻辑调试技巧方面我习惯在关键函数里加TRACE输出比如OnAccept、OnReceive、OnClose用DebugView查看不用打断点也能快速定位流程。另外如果你用Visual Studio 2013记得在工程属性里把字符集设为“使用Unicode字符集”否则CString和char互转的行为会变得很诡异。4.3 关闭程序时崩溃的根因这个坑几乎每个MFC网络程序都会踩你关闭主窗口程序却在析构时崩溃或者报“Debug Assertion Failed”。原因就是CSocket对象的生命周期没管理好。CSocket在底层创建了一个窗口句柄用于接收Winsock消息。如果客户端Socket还没被销毁主窗口先销毁了或者反过来Socket在窗口销毁后还尝试向窗口PostMessage就会访问空指针。正确的关闭顺序是先从窗口消息处理函数中移除对该Socket的引用。调用Close()关闭Socket。delete指针如果是new出来的。最后再结束窗口。另外对话框的OnClose事件里要遍历所有客户端列表逐个关闭并清理。注意CSocket的Close不是线程安全的如果你在DoModal退出前清理Socket建议不要在工作线程里调用Close而是PostMessage回UI线程清理。我在项目里是这么做的维护一个CPtrList m_clientList在窗口销毁时遍历void CServerDlg::CloseAllClient() { POSITION pos m_clientList.GetHeadPosition(); while (pos ! NULL) { CClientSocket* pClient (CClientSocket*)m_clientList.GetNext(pos); if (pClient) { pClient-ShutDown(2); pClient-Close(); delete pClient; } } m_clientList.RemoveAll(); }OnClose回调里最好先判断指针是否非空同时给客户端设置一个“已关闭”标记防止同一个Socket被重复关闭导致二次delete。5. 功能扩展与项目打包5.1 给聊天室增加房间、昵称和心跳基础聊天室跑通之后扩展功能方向很多。一个是增加用户昵称和私聊协议头部可以增加“消息类型”字段0表示公聊1表示私聊2表示系统消息。另一个是心跳检测TCP连接断开并不总是及时比如拔网线、休眠唤醒服务端可能很久之后才感知到客户端已下线。做法是客户端每5秒发送一个心跳包服务端如果10秒没收到某个客户端的数据就主动关闭该Socket。从协议设计角度建议在长度头后面增加1字节的“命令字”这样后续扩展消息类型不用破坏原有格式。我自己的项目后来就加了一个简单的“房间ID”字段客户端在连接时上报要加入的房间服务端维护一个房间到客户端列表的映射消息只在同房间广播实现分频道聊天。5.2 MFC项目打包与分发注意点项目写完之后发布是另一道坎。MFC程序在目标机器上跑需要对应的VC运行库。Visual Studio 2013默认是动态链接MFC所以目标机器需要安装vc_redist_x86.exe或x64。如果你不想带运行库可以在项目属性里把“MFC的使用”改为“在静态库中使用MFC”“运行时库”改为“多线程(/MT)”这样生成的exe就能在裸机上跑体积会大几百KB但省去安装步骤。我建议发布时用Release x86配置因为很多老机器是32位或64位但装了32位兼容库。程序里如果用了控件建议开启manifest自动生成否则可能会出现“初始化失败”的提示。另外如果你在聊天室里用了本地端口7777记得在Windows防火墙里给这个端口加个入站规则否则别的电脑连不上。最后一个小提醒CSocket类默认不支持跨平台这个聊天室程序定位就是Windows局域网内使用。如果你想扩展到Linux服务器可能需要换成异步Socket库或者直接上Boost.Asio。但作为MFC入门级网络编程CSocket这套消息驱动模型确实能让初学者快速理解“网络事件驱动UI”的套路。我后来做其他项目时回看这段代码仍然觉得把协议处理、线程模型、资源生命周期这三件事理清楚比用什么框架都重要。本文还有配套的精品资源点击获取