简介这是一份基于MFC框架与Winsock API实现的TCP服务器源码工程面向具备C基础、希望学习Windows网络编程的开发者尤其适合使用VC6.0环境进行本地编译与调试的初学者。工程围绕CAsyncSocket类展开涵盖监听端口、接受连接、收发数据及错误处理等核心流程并涉及多线程并发处理思路是理解TCP服务器工作原理的完整实践样本。压缩包共20个文件约39KB以h头文件与cpp源文件为主体辅以dsp、dsw工程文件、rc资源脚本及ico图标等结构完整可直接导入VC6.0编译运行。目前已有311人学习下载。读者可从中获得一套可运行的服务器代码骨架对照OnAccept、OnReceive、OnSend等消息处理函数理解异步套接字机制并借助ReadMe说明与工程配置快速搭建调试环境为后续扩展多线程并发与网络通信功能提供参考。1. 从一份 MFC TCP 服务器源码说起它到底能跑什么如果你手头有一份用 MFC 写的 TCP 服务器源码第一反应大概率是这玩意儿现在还有人用但现实是工控上位机、老旧产线采集软件、医疗设备配套工具里MFC 依然是主力框架。这份资源就是一个典型的 MFC SERVER TCP 实现基于CAsyncSocket或CSocket封装跑在 Windows 消息循环里能同时处理多客户端连接、收发字节流。它解决的不是高并发互联网场景而是“一台 Windows 机器上快速起一个稳定监听、跟几台设备或客户端通信”的需求。适合谁做设备联调、写测试工具、维护老项目的 C 开发者。你不需要懂 epoll、IOCP只要会 MFC 的基本对话框和消息映射就能把它跑起来。2. 把 MFC TCP 服务器跑起来环境、编译与监听参数2.1 工程结构与依赖确认拿到源码包先别急着点编译。MFC 项目对 Visual Studio 版本和字符集很敏感。常见结构是一个*.sln解决方案一个*.vcxproj工程里面包含ServerDlg.cpp、ServerDlg.h、ListenSocket.cpp、ClientSocket.cpp等文件。先确认三件事第一工程属性里“使用 MFC”是“在共享 DLL 中使用 MFC”还是“在静态库中使用 MFC”——前者需要目标机器有对应 MFC 运行库后者体积大但独立第二字符集是 Unicode 还是多字节这直接影响CString和char*的转换写法第三平台工具集版本比如 v142 对应 VS2019v143 对应 VS2022版本不匹配会报“找不到 vcruntime”之类的错。我一般会先打开.vcxproj看PlatformToolset和CharacterSet两个标签心里有数了再动编译。如果源码里大量用sprintf而不是_stprintf_s那多半是多字节字符集强行切 Unicode 会出一堆const char*转LPCTSTR的错误。2.2 监听端口与 IP 绑定代码里改哪一行MFC 的 TCP 服务器通常继承CAsyncSocket在OnAccept里接受新连接。核心监听代码长这样// ListenSocket.cpp 中重写 OnAccept void CListenSocket::OnAccept(int nErrorCode) { CAsyncSocket::OnAccept(nErrorCode); if (nErrorCode 0) { CClientSocket* pClient new CClientSocket(this); // Accept 会把新连接的 socket 句柄填入 pClient if (!Accept(*pClient)) { delete pClient; return; } // 把新客户端加入列表供后续广播或单独回复 m_pOwner-AddClient(pClient); } }逻辑说明Accept调用后pClient就持有了与客户端通信的套接字。参数方面Accept的第二个参数可以传一个SOCKADDR结构来获取客户端 IP 和端口不传也行。注意new出来的CClientSocket必须在连接关闭时delete否则每来一个客户端就泄漏一块内存跑几天就崩。监听端口一般在InitInstance或对话框初始化里绑定// 在对话框 OnInitDialog 中 m_listenSocket.Create(8888, SOCK_STREAM, FD_ACCEPT, _T(0.0.0.0)); m_listenSocket.Listen(5);Create的第一个参数是端口第二个是类型第三个是事件掩码第四个是绑定地址。_T(0.0.0.0)表示监听所有网卡。Listen(5)是 backlog意思是还没被Accept的连接最多排 5 个超过的客户端会收到拒绝。设备联调时如果同时连的客户端多这个值要调大比如 20 或 50。2.3 收发数据OnReceive 里的缓冲区处理客户端发数据过来触发OnReceive。这里最常见的翻车点是以为一次Receive就能收完一条完整消息。TCP 是字节流没有消息边界。你发 “HELLO”对方可能先收到 “HE”再收到 “LLO”。所以OnReceive里必须循环收或者按协议长度字段拼包。void CClientSocket::OnReceive(int nErrorCode) { CAsyncSocket::OnReceive(nErrorCode); if (nErrorCode ! 0) return; char szBuf[4096] {0}; int nRead Receive(szBuf, sizeof(szBuf) - 1); if (nRead 0) { // 把收到的数据追加到该客户端的缓冲区 m_recvBuffer.Append(szBuf, nRead); // 按自定义协议解析比如前4字节是长度 ParsePackets(); } else if (nRead 0) { // 对方正常关闭 Close(); } else { int nErr GetLastError(); if (nErr ! WSAEWOULDBLOCK) { // 真错误关闭连接 Close(); } } }参数说明Receive返回大于 0 表示读到的字节数等于 0 表示对方关闭小于 0 要配合GetLastError判断。WSAEWOULDBLOCK不是错误只是当前没数据可读直接忽略。缓冲区大小 4096 是经验值太小会频繁触发OnReceive太大浪费内存。如果传输图片或文件建议改成 8192 或 16384。3. 多客户端管理与线程安全别让界面卡死3.1 用 CArray 还是 std::vector 存客户端MFC 项目里常见两种做法用CArrayCClientSocket*, CClientSocket*或者std::vector。CArray是 MFC 自带跟CString风格一致但性能一般std::vector更现代但要注意在 MFC 消息循环里跨线程访问要加锁。我一般会用一个std::mapSOCKET, CClientSocket*key 是 socket 句柄方便按句柄查找和删除。// 在服务器对话框类中 std::mapSOCKET, CClientSocket* m_clientMap; CRITICAL_SECTION m_cs; // 临界区保护 void AddClient(CClientSocket* pClient) { EnterCriticalSection(m_cs); m_clientMap[pClient-m_hSocket] pClient; LeaveCriticalSection(m_cs); } void RemoveClient(CClientSocket* pClient) { EnterCriticalSection(m_cs); m_clientMap.erase(pClient-m_hSocket); LeaveCriticalSection(m_cs); delete pClient; // 注意先移除再删除 }逻辑说明m_hSocket是CAsyncSocket的成员保存底层 socket 句柄。用临界区是因为OnAccept、OnReceive、OnClose都在 MFC 的消息线程里但如果你开了工作线程去处理业务就可能并发访问这个 map。不加锁的后果是一个线程在遍历发广播另一个线程删除了元素迭代器失效程序直接崩。3.2 广播与定向发送Send 的返回值别忽略给所有客户端发消息或者给指定客户端回数据都要调Send。Send返回实际发送的字节数可能小于你传入的长度尤其是发送大块数据时。所以正确做法是循环发送直到发完或出错。bool SendAll(CClientSocket* pClient, const char* pData, int nLen) { int nSent 0; while (nSent nLen) { int nRet pClient-Send(pData nSent, nLen - nSent); if (nRet SOCKET_ERROR) { int nErr GetLastError(); if (nErr WSAEWOULDBLOCK) { // 发送缓冲区满等一会儿再试 Sleep(10); continue; } return false; // 真错误 } nSent nRet; } return true; }参数说明Send的第二个参数是剩余长度第一个参数要偏移。WSAEWOULDBLOCK表示内核发送缓冲区满了不是错误等 10 毫秒重试即可。如果一直满说明客户端接收太慢可以考虑断开或丢包。注意Sleep在 UI 线程里会卡界面所以广播操作最好放在工作线程或者用PostMessage异步通知。3.3 界面刷新与工作线程的配合MFC 的对话框控件只能在主线程更新。如果你在OnReceive里直接SetDlgItemText数据量大时界面会卡成幻灯片。常见做法是收到数据后把要显示的内容PostMessage给主窗口主窗口收到自定义消息再更新控件。// 自定义消息 #define WM_APPEND_LOG (WM_USER 100) // 在 OnReceive 中 CString* pStr new CString(szBuf); PostMessage(WM_APPEND_LOG, (WPARAM)pStr, 0); // 消息处理函数 LRESULT CServerDlg::OnAppendLog(WPARAM wParam, LPARAM lParam) { CString* pStr (CString*)wParam; m_logEdit.SetSel(-1, -1); m_logEdit.ReplaceSel(*pStr); delete pStr; return 0; }逻辑说明PostMessage是异步的不会阻塞OnReceive。new CString在堆上分配消息处理完后delete避免跨线程传递栈变量。如果直接传char*要确保生命周期足够长否则消息还没处理缓冲区就被复用了。4. 避坑与排查MFC TCP 服务器最常见的五个翻车点4.1 现象客户端连不上服务器没反应原因防火墙拦截了监听端口或者Create时绑定了127.0.0.1而不是0.0.0.0。另外如果Listen的 backlog 设得太小同时连接数超过 backlog新连接会被拒绝。解决先用netstat -ano | findstr 8888看端口有没有在监听。如果监听地址是127.0.0.1:8888改成0.0.0.0:8888。然后在 Windows 防火墙入站规则里放行该端口。backlog 建议设为 20 以上。4.2 现象运行一段时间后内存暴涨原因OnAccept里new了CClientSocket但客户端断开时没有delete。或者OnReceive里new CString后PostMessage失败指针丢了。解决在OnClose里统一清理。给CClientSocket加一个m_bClosed标志确保只删除一次。PostMessage后如果返回 FALSE要手动delete那个CString。4.3 现象中文乱码原因服务器用多字节字符集客户端用 UTF-8或者反过来。CString的GetBuffer和ReleaseBuffer用错也会导致乱码。解决统一字符集。如果服务器是多字节收到 UTF-8 数据后先MultiByteToWideChar转成宽字符再显示。发送时用WideCharToMultiByte转回 UTF-8。别在CString和std::string之间反复横跳。4.4 现象OnReceive 不触发或只触发一次原因CAsyncSocket的事件掩码没设对。Create时只传了FD_ACCEPT没传FD_READ和FD_CLOSE那客户端发数据过来就不会触发OnReceive。解决Create的第三个参数改成FD_ACCEPT | FD_READ | FD_CLOSE | FD_WRITE。如果用的是CSocket它内部会处理但CAsyncSocket必须手动指定。4.5 现象程序退出时崩溃原因对话框关闭时监听 socket 和客户端 socket 没有正确CloseMFC 对象析构时底层句柄还在导致访问已释放内存。解决在OnDestroy或OnCancel里先遍历m_clientMap逐个Close并delete然后m_listenSocket.Close()。顺序不能反先关客户端再关监听。5. 进阶技巧用 Wireshark 抓包验证与心跳保活5.1 抓包看三次握手和实际收发代码写完了客户端说“连不上”别猜。打开 Wireshark选对网卡过滤tcp.port 8888。正常流程是客户端发 SYN服务器回 SYNACK客户端再回 ACK。如果只看到 SYN 没有 SYNACK说明服务器根本没收到检查防火墙或 IP 绑定。如果握手成功但没数据看OnReceive有没有触发或者客户端是不是没发。我一般会同时开 Wireshark 和服务器日志。日志里打印OnAccept的客户端 IP 和端口跟 Wireshark 里的源端口对一下确认是不是同一个连接。有一次调了半天发现客户端连的是另一台机器的同端口血泪经验。5.2 心跳包与超时断开TCP 连接建立后如果客户端拔网线服务器可能很久都不知道。OnClose不会触发因为对方没有发 FIN。这时候需要心跳机制服务器每隔 30 秒给所有客户端发一个心跳包如果Send返回错误或者连续 3 次没收到客户端回应就主动Close。// 在对话框里加一个定时器 SetTimer(1, 30000, nullptr); void CServerDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent 1) { EnterCriticalSection(m_cs); for (auto pair : m_clientMap) { CClientSocket* pClient pair.second; if (!SendAll(pClient, PING, 4)) { // 发送失败标记待删除 pClient-m_bTimeout true; } } // 清理超时客户端 for (auto it m_clientMap.begin(); it ! m_clientMap.end(); ) { if (it-second-m_bTimeout) { it-second-Close(); delete it-second; it m_clientMap.erase(it); } else { it; } } LeaveCriticalSection(m_cs); } CDialogEx::OnTimer(nIDEvent); }参数说明定时器间隔 30000 毫秒是经验值太短浪费带宽太长发现断线慢。SendAll返回 false 时不要立刻删因为可能是发送缓冲区暂时满标记一下下一轮再判断。清理时用迭代器erase的返回值继续遍历不要it后再erase那样会崩。5.3 用 SO_KEEPALIVE 还是应用层心跳CAsyncSocket可以设SO_KEEPALIVE但默认间隔是 2 小时改注册表也麻烦。应用层心跳更可控还能附带业务状态。我一般两者都开SO_KEEPALIVE兜底应用层心跳做快速检测。设置方法int nKeepAlive 1; m_listenSocket.SetSockOpt(SO_KEEPALIVE, nKeepAlive, sizeof(nKeepAlive));注意SetSockOpt要在Create之后、Listen之前调用。客户端 socket 继承监听 socket 的选项但最好在Accept后单独再设一次。从那以后我每次写完 MFC TCP 服务器都会先跑一个模拟客户端脚本连上后发 10 万条随机数据看内存和 CPU 曲线。再拔网线测心跳确认 30 秒内能清理掉死连接。这套流程走完基本不会在联调现场翻车。希望帮到你。本文还有配套的精品资源点击获取
