简介这份资源是一套基于MFC框架实现的邮件收发程序源码面向学习C网络编程、需要完成课程设计或想了解SMTP与POP3协议实践的学生与开发者。程序可正常运行发送端支持带附件邮件附件大小实测约5M接收端按编号列出邮件单击即可查看内容并附带黑名单功能黑名单文件默认放在C盘可按需修改路径。压缩包共34个文件约3.53MB以cpp、h源码文件为核心配合rc资源脚本、dsp与dsw工程文件、exe可执行程序及obj、pdb等编译中间产物另有ReadMe说明结构完整便于直接打开工程调试。目前已有480人学习下载。需要留意的是接收端未将报文头、正文与附件分离附件也未做base64解码适合作为二次开发起点读者可在此基础上补充解析与解码逻辑完善邮件客户端功能。1. 从零手搓 MFC 邮件收发器SMTP 与 POP3 的底层实现到底难在哪很多人第一次接触网络编程都是从“写一个能发邮件的工具”开始的。但真动手才发现用 C 和 MFC 把 SMTP 发信和 POP3 收信跑通远不是调个库那么简单。市面上现成的邮件客户端不少可一旦要嵌入自己的 MFC 工程、要自定义附件编码、要处理中文主题乱码那些封装好的组件往往就不好使了。这份资源给的正是一个纯 MFC 框架下的邮件收发器实现基于 WinSock 原生套接字手动实现 SMTP 和 POP3 协议交互不依赖第三方邮件库。它适合两类人一是正在学 MFC 网络编程、想找一个完整可运行案例的开发者二是需要在现有 C 桌面项目里集成邮件通知功能、又不想引入额外依赖的工程师。下面我从协议交互、代码结构、参数配置到实际踩坑把这份资源拆开讲透。2. 协议先行SMTP 与 POP3 的报文交互到底怎么走2.1 SMTP 发信流程与关键命令SMTP 的本质就是客户端和服务器之间一来一回的文本对话。整个发信过程可以拆成五个阶段建立 TCP 连接、握手与认证、指定发件人与收件人、传输邮件数据、断开连接。每个阶段都有对应的命令和期望的响应码搞错一步就会卡住。常见做法是用 WinSock 的connect连上目标服务器的 25 端口现在多数要求 465 或 587 走加密但这份资源聚焦明文协议教学端口可配。连上之后服务器会主动推一行220开头的欢迎语客户端必须读完这行才能继续。接着发EHLO或HELO表明身份服务器返回250表示认可。如果服务器支持认证EHLO的响应里会带AUTH关键字。认证阶段是最容易翻车的地方。AUTH LOGIN之后服务器会先要用户名再要密码而且都要求 Base64 编码。很多人直接发明文结果收到535认证失败还以为是密码错了。实际上编码本身不难但 Base64 后的字符串末尾不能有多余换行否则服务器解析会出问题。认证通过后用MAIL FROM指定发件人RCPT TO指定收件人每个命令都要等服务器返回250才能发下一条。然后发DATA服务器回354此时开始传输邮件内容。邮件内容分头部和正文头部必须包含From、To、Subject、Date、MIME-Version等字段正文和头部之间用一个空行隔开。传输结束后发一个单独的点号.表示结束服务器返回250表示接收成功。最后发QUIT断开。这里有个细节如果邮件正文里某一行恰好以点号开头SMTP 协议要求在前面再加一个点号做转义否则服务器会误认为邮件提前结束。这个点在发纯文本邮件时不容易遇到但发代码片段或日志文件时几乎必踩。2.2 POP3 收信流程与状态机POP3 比 SMTP 简单一些但状态切换更严格。连接建立后进入“授权状态”此时只能发USER和PASS两个命令。认证成功后进入“事务状态”才能用STAT、LIST、RETR、DELE、QUIT等命令。如果顺序搞反服务器直接返回-ERR。收信的基本流程是USER发用户名PASS发密码STAT查邮件总数和总大小LIST列出每封邮件的编号和大小RETR按编号取回邮件内容DELE标记删除最后QUIT真正执行删除并断开。注意DELE只是打标记只有QUIT之后才会真正删掉如果中途连接断了删除不会生效。这个机制其实是个保护但如果不清楚会以为删不掉是代码有 bug。RETR返回的邮件内容是完整的 RFC 822 格式包含头部和正文多行响应以.单独一行结束。和 SMTP 一样如果正文行以点号开头前面会多一个点号解析时需要还原。另外 POP3 返回的字符串里换行是\r\n在 Windows 上显示要转成\r\n或\n否则 MFC 的 Edit 控件里会看到一堆方块。2.3 为什么不用现成库而手写协议有人会问既然有 libcurl、有 OpenSSL为什么还要手写原因有几个。第一MFC 工程引入第三方库会带来编译配置、运行时库版本、部署依赖等一系列问题尤其是老项目用 VC6 或 VS2010 的很多现代库根本不兼容。第二手写协议能完全控制超时、重试、编码转换这些细节遇到服务器兼容性问题时好排查。第三教学场景下手写一遍才能真正理解邮件协议的状态机和报文格式这比调 API 有价值得多。当然手写也有代价。加密连接SSL/TLS需要额外实现附件编码要自己处理 Base64 和 quoted-printable中文编码要处理 GB2312 和 UTF-8 的转换。这份资源的价值在于给出了一个可运行的基线你可以在这个基础上按需扩展。3. 代码落地MFC 工程里怎么组织 SMTP 与 POP3 模块3.1 工程结构与核心类划分拿到源码后先别急着编译。花几分钟看一下目录结构能省很多事。典型的组织方式是按功能分层网络通信层、协议解析层、界面层。网络通信层封装 WinSock 的初始化和 TCP 连接协议解析层实现 SMTP 和 POP3 的命令收发与响应解析界面层用 MFC 对话框做交互。常见做法是定义一个CMailSocket基类继承自CAsyncSocket或直接封装SOCKET提供Connect、SendLine、RecvLine这些基础方法。然后CSmtpClient和CPop3Client各自继承它实现具体的协议流程。界面层用一个主对话框上面放服务器地址、端口、用户名、密码、收件人、主题、正文这些控件再加发送和接收按钮。这里有个设计选择用阻塞 socket 还是非阻塞。MFC 的CAsyncSocket是非阻塞的适合界面不卡死但状态管理复杂。阻塞 socket 写起来直观但要在工作线程里跑否则界面会假死。我一般会开一个工作线程处理网络操作主线程只负责界面刷新线程间用自定义消息通信。这样既保证界面响应又让协议代码保持顺序执行的清晰逻辑。3.2 SMTP 发信核心代码与参数说明下面这段代码展示了 SMTP 发信的核心流程基于阻塞 socket 封装。实际使用时需要放在工作线程里执行。// 假设 m_socket 是已封装的阻塞 socket 对象 // server、port、user、pass、from、to、subject、body 为外部传入参数 bool CSmtpClient::SendMail(LPCTSTR server, int port, LPCTSTR user, LPCTSTR pass, LPCTSTR from, LPCTSTR to, LPCTSTR subject, LPCTSTR body) { // 1. 建立 TCP 连接 if (!m_socket.Connect(server, port, 10000)) // 超时 10 秒 return false; // 2. 读取服务器欢迎语期望 220 CString resp m_socket.RecvLine(); if (resp.Left(3) ! _T(220)) return false; // 3. 发送 EHLO期望 250 m_socket.SendLine(_T(EHLO myclient\r\n)); resp m_socket.RecvLine(); if (resp.Left(3) ! _T(250)) return false; // 4. AUTH LOGIN 认证 m_socket.SendLine(_T(AUTH LOGIN\r\n)); resp m_socket.RecvLine(); // 期望 334 if (resp.Left(3) ! _T(334)) return false; // 发送 Base64 编码的用户名 CString b64user Base64Encode(user); m_socket.SendLine(b64user _T(\r\n)); resp m_socket.RecvLine(); // 期望 334 if (resp.Left(3) ! _T(334)) return false; // 发送 Base64 编码的密码 CString b64pass Base64Encode(pass); m_socket.SendLine(b64pass _T(\r\n)); resp m_socket.RecvLine(); // 期望 235 if (resp.Left(3) ! _T(235)) return false; // 5. MAIL FROM CString cmd; cmd.Format(_T(MAIL FROM:%s\r\n), from); m_socket.SendLine(cmd); resp m_socket.RecvLine(); // 期望 250 if (resp.Left(3) ! _T(250)) return false; // 6. RCPT TO cmd.Format(_T(RCPT TO:%s\r\n), to); m_socket.SendLine(cmd); resp m_socket.RecvLine(); // 期望 250 if (resp.Left(3) ! _T(250)) return false; // 7. DATA m_socket.SendLine(_T(DATA\r\n)); resp m_socket.RecvLine(); // 期望 354 if (resp.Left(3) ! _T(354)) return false; // 8. 构造邮件头部和正文 CString mailData; mailData.Format(_T(From: %s\r\n), from); mailData CString(_T(To: )) to _T(\r\n); mailData CString(_T(Subject: )) subject _T(\r\n); mailData _T(MIME-Version: 1.0\r\n); mailData _T(Content-Type: text/plain; charset\GB2312\\r\n); mailData _T(\r\n); // 空行分隔头部和正文 mailData body; mailData _T(\r\n.\r\n); // 结束标记 m_socket.SendLine(mailData); resp m_socket.RecvLine(); // 期望 250 if (resp.Left(3) ! _T(250)) return false; // 9. QUIT m_socket.SendLine(_T(QUIT\r\n)); m_socket.Close(); return true; }这段代码里几个关键点值得展开。Connect的超时参数设成 10000 毫秒是因为有些邮件服务器响应慢设太短会误判失败。RecvLine需要自己实现按行读取注意处理\r\n和缓冲区边界。Base64 编码函数要确保输出没有多余换行否则认证会失败。邮件头部的charset设成GB2312是为了兼容中文 Windows 环境如果服务器要求 UTF-8改成UTF-8并对主题和正文做相应编码转换。SendLine和RecvLine的封装也有讲究。SendLine要确保一次发完因为 TCP 是流式的send返回值可能小于请求长度需要循环发送。RecvLine要处理粘包问题不能假设一次recv就能拿到完整一行要累积到遇到\r\n为止。3.3 POP3 收信核心代码与解析要点收信部分的代码结构和发信类似但多了邮件内容的解析。下面这段展示了从连接服务器到取回第一封邮件的过程。bool CPop3Client::ReceiveMail(LPCTSTR server, int port, LPCTSTR user, LPCTSTR pass, CStringArray mailList) { // 1. 连接服务器 if (!m_socket.Connect(server, port, 10000)) return false; // 2. 读取欢迎语期望 OK CString resp m_socket.RecvLine(); if (resp.Left(3) ! _T(OK)) return false; // 3. USER 命令 CString cmd; cmd.Format(_T(USER %s\r\n), user); m_socket.SendLine(cmd); resp m_socket.RecvLine(); if (resp.Left(3) ! _T(OK)) return false; // 4. PASS 命令 cmd.Format(_T(PASS %s\r\n), pass); m_socket.SendLine(cmd); resp m_socket.RecvLine(); if (resp.Left(3) ! _T(OK)) return false; // 5. STAT 查询邮件数量 m_socket.SendLine(_T(STAT\r\n)); resp m_socket.RecvLine(); if (resp.Left(3) ! _T(OK)) return false; // 解析 OK 3 1024 中的数量 int mailCount 0; _stscanf_s(resp.Mid(4), _T(%d), mailCount); // 6. 逐封取回 for (int i 1; i mailCount; i) { cmd.Format(_T(RETR %d\r\n), i); m_socket.SendLine(cmd); resp m_socket.RecvLine(); if (resp.Left(3) ! _T(OK)) continue; // 读取邮件内容直到遇到单独的 . CString mailContent; while (true) { CString line m_socket.RecvLine(); if (line _T(.)) break; // 还原点号转义 if (line.Left(2) _T(..)) line line.Mid(1); mailContent line _T(\r\n); } mailList.Add(mailContent); } // 7. QUIT 断开 m_socket.SendLine(_T(QUIT\r\n)); m_socket.Close(); return true; }这段代码里STAT返回的格式是OK 数量 总字节数用Mid(4)跳过OK再解析数字。RETR之后读取内容时要一直读到单独一行的点号为止同时处理点号转义。取回的mailContent是完整的 RFC 822 格式后续要解析头部字段和正文还要处理 MIME 编码的附件和中文。解析头部时常见做法是按行扫描遇到空行就认为头部结束。每个头部字段是Key: Value格式注意值可能折行以空格或制表符开头的行是上一行的延续。中文主题通常用?GB2312?B?或?UTF-8?B?开头需要 Base64 解码后再转成CString。附件部分用boundary分隔每个部分有自己的Content-Type和Content-Transfer-Encoding要分别处理。3.4 界面层与线程通信MFC 对话框的界面刷新必须在主线程做网络操作放在工作线程。线程间通信用PostMessage发自定义消息主线程收到后更新控件。比如发信成功后发WM_SEND_DONE收信完成后发WM_RECV_DONE并把邮件列表传过去。这里有个坑PostMessage传CString指针时要注意内存生命周期。如果在线程里new一个CString主线程收到后要负责delete否则内存泄漏。更安全的做法是用std::shared_ptr或者把数据放到线程安全的队列里主线程定时取。界面控件方面服务器地址和端口用CEdit用户名密码也用CEdit但密码框设ES_PASSWORD。正文用多行CEdit并勾选Want Return和MultiLine。发送和接收按钮分别绑定BN_CLICKED消息在响应函数里启动工作线程。状态栏或日志框用来显示协议交互过程方便排查问题。4. 避坑指南SMTP 与 POP3 实现中最容易翻车的五个点4.1 认证失败但密码明明是对的现象发AUTH LOGIN后服务器返回535提示认证失败但用网页端登录同一账号没问题。原因最常见的是 Base64 编码后带了换行符。很多 Base64 实现会在输出末尾加\r\n而 SMTP 协议要求命令以\r\n结尾如果编码结果本身带了换行就会变成两个换行服务器解析出错。另一个原因是用户名需要带完整域名比如userexample.com而不是user。解决检查 Base64 编码函数的输出确保没有多余换行。可以在编码后手动去掉\r和\n。用户名按服务器要求填写完整地址。如果服务器要求AUTH PLAIN而不是AUTH LOGIN需要换一种认证方式AUTH PLAIN是把\0用户名\0密码整体 Base64 编码后一次发送。4.2 中文主题显示为乱码现象发出的邮件主题在收件箱里显示为?GB2312?B?xxxx?或者一堆问号。原因邮件头部的中文字符不能直接发送必须按 RFC 2047 编码。常见做法是用?字符集?编码方式?编码后的内容?的格式。如果只做了 Base64 编码但没加?GB2312?B?前缀和后缀客户端无法识别。另外如果正文的Content-Type里charset设成了UTF-8但实际发送的是 GB2312 字节流也会乱码。解决主题字段用?GB2312?B? Base64(主题) ?的格式。正文的charset要和实际编码一致。如果服务器和客户端都支持 UTF-8统一用 UTF-8 更省事但要注意 MFC 的CString在 Unicode 配置下是 UTF-16转 UTF-8 需要调WideCharToMultiByte。4.3 邮件发送成功但收件人收不到现象SMTP 交互全部返回250QUIT也正常但收件人就是没收到。原因可能是被当成垃圾邮件拦截了。常见触发因素包括发件人域名和实际服务器不匹配、邮件头部缺少Date和Message-ID、正文包含大量链接或敏感词、发送频率过高。另外如果MAIL FROM的地址是随意填的很多服务器会直接拒收或丢进垃圾箱。解决确保MAIL FROM是真实存在的邮箱地址。邮件头部加上Date字段格式为Date: Mon, 1 Jan 2024 00:00:00 0800。加上Message-ID格式类似timestamp.randomdomain。控制发送频率测试时不要连续快速发送。如果条件允许配置 SPF 和 DKIM 记录但这超出客户端代码范围。4.4 POP3 取回的邮件内容不完整现象RETR返回OK但读到的内容比实际邮件短或者附件损坏。原因RecvLine的缓冲区太小遇到长行时被截断。或者读取循环在遇到\r\n.\r\n时提前结束但实际邮件内容里恰好有这一串。另外如果邮件包含二进制附件经过 quoted-printable 编码后可能有软换行解析时没还原。解决增大RecvLine的缓冲区至少 4096 字节并且要处理缓冲区满但还没遇到换行的情况。结束判断要严格按“单独一行的点号”来不能简单搜索\r\n.\r\n。对于 quoted-printable 编码要处理结尾的软换行和XX形式的十六进制转义。4.5 界面卡死或无响应现象点击发送按钮后界面直接卡住进度条不动也无法取消。原因网络操作在主线程执行阻塞 socket 的connect或recv在等待服务器响应时挂起消息循环被阻塞界面自然不刷新。解决把网络操作放到AfxBeginThread创建的工作线程里。主线程只负责界面刷新和消息响应。线程里通过PostMessage通知主线程更新状态。如果需要在等待时支持取消可以用非阻塞 socket 加select超时或者设置 socket 的SO_RCVTIMEO选项让recv在超时后返回线程检查取消标志后决定是否继续。5. 进阶技巧附件编码、SSL 连接与多收件人处理5.1 附件发送的 MIME 编码发纯文本邮件只是入门实际工作中经常要发附件。附件的处理比正文复杂需要构造multipart/mixed类型的邮件体。基本结构是邮件头部声明Content-Type: multipart/mixed; boundaryXXXX然后正文部分和附件部分用--XXXX分隔最后用--XXXX--结束。每个附件部分有自己的头部包括Content-Type根据文件类型设比如application/octet-stream、Content-Transfer-Encoding: base64、Content-Disposition: attachment; filename...。文件名如果有中文也要按 RFC 2047 编码。附件内容读成二进制后做 Base64 编码每 76 个字符加一个换行。// 构造附件部分的示例 CString MakeAttachmentPart(LPCTSTR filePath, LPCTSTR fileName) { CString part; part.Format(_T(--%s\r\n), BOUNDARY); part _T(Content-Type: application/octet-stream\r\n); part _T(Content-Transfer-Encoding: base64\r\n); CString disp; disp.Format(_T(Content-Disposition: attachment; filename\%s\\r\n), EncodeHeader(fileName)); // 中文文件名编码 part disp; part _T(\r\n); // 读取文件并 Base64 编码 CFile file; if (!file.Open(filePath, CFile::modeRead | CFile::typeBinary)) return _T(); ULONGLONG len file.GetLength(); BYTE* buf new BYTE[(UINT)len]; file.Read(buf, (UINT)len); file.Close(); CString b64 Base64EncodeBinary(buf, (int)len); delete[] buf; // 每 76 字符加换行 part WrapLines(b64, 76); part _T(\r\n); return part; }这里BOUNDARY是一个唯一字符串比如----_NextPart_000_001要确保邮件正文里不会出现同样的字符串。EncodeHeader处理中文文件名WrapLines按 76 字符折行。附件部分构造完后和正文部分拼接最后加上--BOUNDARY--结束。5.2 SSL/TLS 连接的实现思路现在主流邮件服务器都要求加密连接明文 25 端口基本被淘汰。要在 MFC 里实现 SSL常见做法是引入 OpenSSL 或者用 Windows 自带的 SChannel。OpenSSL 跨平台但配置麻烦SChannel 是 Windows 原生但 API 较底层。如果只是教学或内网使用可以先跳过 SSL用明文端口测试协议逻辑。如果要实际使用建议用 OpenSSL 的SSL_connect替换普通connect后续的SSL_read和SSL_write替换recv和send。注意 SSL 握手要在 TCP 连接建立后立即进行握手成功后再走 SMTP 或 POP3 的命令交互。另一个选择是用STARTTLS命令。先明文连接发STARTTLS服务器返回220后再在同一个 socket 上启动 SSL 握手。这种方式端口不变但需要服务器支持。POP3 的STLS命令类似。5.3 多收件人与抄送处理RCPT TO可以多次发送每次指定一个收件人。邮件头部的To字段可以包含多个地址用逗号分隔。抄送用Cc字段密送用Bcc字段但Bcc不会出现在邮件头部只在RCPT TO里指定。// 多收件人发送示例 CStringArray recipients; recipients.Add(_T(aexample.com)); recipients.Add(_T(bexample.com)); for (int i 0; i recipients.GetSize(); i) { CString cmd; cmd.Format(_T(RCPT TO:%s\r\n), recipients[i]); m_socket.SendLine(cmd); resp m_socket.RecvLine(); if (resp.Left(3) ! _T(250)) { // 记录失败的收件人继续发下一个 continue; } }注意有些服务器对单封邮件的收件人数量有限制超过会返回452或550。实际使用时建议分批发送每批不超过 50 个。5.4 验证与调试方法调试邮件协议最有效的方法是抓包。用 Wireshark 过滤tcp.port 25 || tcp.port 110能看到完整的命令和响应交互。对比你的代码发送的内容和抓包结果很容易发现格式问题。另一个方法是在代码里加日志把每次SendLine和RecvLine的内容写到文件里。注意日志里不要记录密码明文可以只记录命令类型。测试时先用自己给自己发确认基本流程通了再测试附件和中文。从那以后我每次写网络协议相关的代码都强制先抓包确认报文格式再对照代码逐行检查。这个习惯帮我省了无数个加班的夜晚。希望帮到你。本文还有配套的精品资源点击获取