尧图网页设计 
简介这是一份面向高校计算机网络课程设计场景的模拟邮件系统完整项目源码适合正在完成课程作业或希望理解邮件收发底层协议的学生与开发者。项目基于SMTP与POP3协议实现用户注册登录、资料编辑、发信、收件箱查看及来信回复等核心功能并支持与公网邮箱绑定后完成真实邮件投递。技术栈采用MVC架构以Maven组织工程整合Servlet、JSP、MyBatis与JavaMail配置好数据库即可运行便于快速搭建与二次开发。资源包共58个文件约119KB包含12个Java源文件、12个class编译文件、10个XML配置、6个JSP页面及CSS、properties等资源覆盖后端逻辑、前端展示与工程配置各层面。目前已有3493人学习下载可作为课程设计参考方案帮助读者理清邮件协议交互流程、掌握JavaMail调用方式与SSM整合思路并借鉴其目录结构与配置组织方式。1. 模拟邮件系统从一封邮件的旅程看懂 SMTP 与 POP3很多人做计算机网络课程设计时第一反应是抓包分析或者写个聊天室但真正能把 SMTP 和 POP3 讲清楚的人不多。模拟邮件系统这个题目看起来简单——发邮件、收邮件但背后涉及 TCP 连接管理、应用层协议状态机、Base64 编码、MIME 格式、多线程并发是一个能同时考察网络编程和协议理解的综合题。我带过几届课设发现大部分同学卡在三个地方一是把 SMTP 和 POP3 混在一起写二是不知道邮件正文为什么要编码三是服务器端用单线程导致只能服务一个客户端。这篇笔记按实际做一遍的顺序展开从协议原理到代码落地再到调试时那些让人抓狂的坑目标是让你能照着跑通一个可演示、可答辩的版本。适合正在做计算机网络课程设计、需要交一个能跑的系统并且要讲清楚原理的读者。2. 先把协议聊明白SMTP 发信和 POP3 收信到底怎么配合2.1 SMTP 的会话流程与命令集SMTP 是推协议客户端主动把邮件推给服务器。一次典型的会话从 TCP 三次握手开始然后服务器发 220 问候客户端依次发 HELO/EHLO、MAIL FROM、RCPT TO、DATA最后 QUIT 断开。每个命令都有对应的数字响应码比如 250 表示成功354 表示可以开始发数据550 表示邮箱不可用。这里有个容易翻车的地方很多人以为 SMTP 只负责发信实际上它也能做中继但课程设计里我们只实现最简模型——客户端直连服务器服务器把邮件存到本地用户目录。命令交互是纯文本的用 Telnet 就能手动走一遍这是调试时最有效的验证手段。# 用 Telnet 手动走一遍 SMTP 会话验证服务器响应是否正确 telnet 127.0.0.1 25 # 服务器返回 220 mail.local SMTP Ready HELO test # 返回 250 Hello test MAIL FROM:alicelocal # 返回 250 OK RCPT TO:boblocal # 返回 250 OK DATA # 返回 354 End data with CRLF.CRLF Subject: test mail From: alicelocal To: boblocal Hello Bob, this is a test. . # 返回 250 Message accepted QUIT # 返回 221 Bye上面这段交互里DATA 之后的单独一行点号表示邮件内容结束这是 SMTP 的约定。如果正文里恰好有一行只有一个点需要写成两个点来转义这个细节在解析时经常被忽略导致邮件内容被截断。2.2 POP3 的三种状态与收信命令POP3 是拉协议客户端主动去服务器取邮件。会话分三个状态认证状态USER/PASS、事务状态STAT、LIST、RETR、DELE、更新状态QUIT 后真正删除标记的邮件。和 SMTP 不同POP3 在 QUIT 之前删除的邮件只是打标记QUIT 时才真正落盘删除。课程设计里常见的做法是服务器为每个用户维护一个 maildrop 文件每封邮件用特定分隔符隔开。客户端 RETR 时按邮件序号返回整封邮件内容包括头部和正文。这里要注意POP3 的响应是多行模式第一行是 OK后续行是数据最后以单独的点号结束。# POP3 服务器端处理 RETR 命令的核心逻辑 def handle_retr(self, msg_num): 返回指定序号的邮件内容多行模式以 . 结束 if msg_num 1 or msg_num len(self.maildrop): return -ERR no such message\r\n msg self.maildrop[msg_num - 1] # 多行响应OK 开头逐行发送最后单独一行点号 response OK message follows\r\n for line in msg.split(\r\n): # 如果正文行以点开头需要转义为两个点 if line.startswith(.): line . line response line \r\n response .\r\n return response这段代码里maildrop是一个列表每个元素是一封完整的邮件字符串。转义逻辑是 POP3 的硬性要求不处理的话客户端会把正文里的点号误认为结束标志。参数msg_num从 1 开始和 LIST 命令返回的序号对应。2.3 为什么选 Python socket 而不是现成库课程设计的核心是理解协议不是调库。用 Python 的socket模块从零实现能让你看清每个字节的收发过程。如果直接用smtplib和poplib虽然能跑通但答辩时老师问一句“SMTP 的 DATA 阶段怎么判断结束”就答不上来了。我一般会建议学生先用 socket 写一个最小版本服务器监听 25 和 110 端口收到连接后 fork 一个线程处理按状态机解析命令。客户端也手写用 socket 连上去发命令、读响应。这样整个流程完全可控调试时可以在任意位置打日志。提示课程设计环境里 25 端口可能被系统占用或需要管理员权限建议改用 2525 和 1100 这类高位端口客户端连接时指定端口即可。3. 动手写代码服务器端状态机与客户端交互实现3.1 服务器主循环与多线程模型服务器要同时处理 SMTP 和 POP3 两种协议最简单的做法是开两个监听端口每个端口一个独立线程 accept收到连接后再为每个客户端开一个处理线程。这样结构清晰也方便分别调试。import socket import threading class MailServer: def __init__(self, smtp_port2525, pop3_port1100): self.smtp_port smtp_port self.pop3_port pop3_port self.users {alice: 123456, bob: 123456} self.mailboxes {alice: [], bob: []} def start(self): # SMTP 监听线程 smtp_sock socket.socket(socket.AF_INET, socket.SOCK_STREAM) smtp_sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) smtp_sock.bind((0.0.0.0, self.smtp_port)) smtp_sock.listen(5) threading.Thread(targetself.accept_loop, args(smtp_sock, SMTP), daemonTrue).start() # POP3 监听线程 pop3_sock socket.socket(socket.AF_INET, socket.SOCK_STREAM) pop3_sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) pop3_sock.bind((0.0.0.0, self.pop3_port)) pop3_sock.listen(5) threading.Thread(targetself.accept_loop, args(pop3_sock, POP3), daemonTrue).start() def accept_loop(self, sock, proto): while True: conn, addr sock.accept() threading.Thread(targetself.handle_client, args(conn, proto), daemonTrue).start()SO_REUSEADDR是为了避免服务器重启时端口被 TIME_WAIT 状态占用。daemonTrue让线程随主进程退出调试时不会残留。每个连接一个线程的模型在课设规模下完全够用但要注意共享数据mailboxes的线程安全后面会讲怎么加锁。3.2 SMTP 会话的状态机实现SMTP 处理函数需要维护一个会话状态当前是否已 HELO、发件人是谁、收件人列表、是否在 DATA 阶段。用简单的字符串判断就能实现但状态多了容易乱建议用字典显式记录。def handle_smtp(self, conn): conn.sendall(b220 mail.local SMTP Ready\r\n) state {helo: False, from: None, rcpt: [], data_mode: False} buffer b while True: chunk conn.recv(4096) if not chunk: break buffer chunk while b\r\n in buffer: line, buffer buffer.split(b\r\n, 1) text line.decode(utf-8, errorsignore).strip() if state[data_mode]: if text .: # 邮件结束投递到收件人邮箱 self.deliver_mail(state[from], state[rcpt], state[data_lines]) conn.sendall(b250 Message accepted\r\n) state.update({data_mode: False, from: None, rcpt: [], data_lines: []}) else: state[data_lines].append(text) continue # 命令解析 cmd text.split( )[0].upper() if cmd HELO or cmd EHLO: state[helo] True conn.sendall(b250 Hello\r\n) elif cmd MAIL: state[from] text.split(:)[-1].strip() conn.sendall(b250 OK\r\n) elif cmd RCPT: state[rcpt].append(text.split(:)[-1].strip()) conn.sendall(b250 OK\r\n) elif cmd DATA: state[data_mode] True state[data_lines] [] conn.sendall(b354 End data with CRLF.CRLF\r\n) elif cmd QUIT: conn.sendall(b221 Bye\r\n) return else: conn.sendall(b500 Unknown command\r\n)这里用buffer累积数据再按\r\n切分是为了处理 TCP 粘包。如果直接recv一次就解析客户端快速发送多条命令时可能读到半条。data_lines在 DATA 阶段收集正文遇到单独的点号就投递。投递函数deliver_mail需要给每个收件人的邮箱列表追加邮件这里要加锁。3.3 POP3 认证与邮件读取POP3 比 SMTP 简单但要注意认证状态和事务状态的切换。USER 和 PASS 都正确后才进入事务状态之后才能执行 STAT、LIST、RETR、DELE。def handle_pop3(self, conn): conn.sendall(bOK POP3 server ready\r\n) state {user: None, authed: False, deleted: set()} buffer b while True: chunk conn.recv(4096) if not chunk: break buffer chunk while b\r\n in buffer: line, buffer buffer.split(b\r\n, 1) text line.decode(utf-8, errorsignore).strip() cmd text.split( )[0].upper() if not state[authed]: if cmd USER: state[user] text.split( )[1] conn.sendall(bOK\r\n) elif cmd PASS: pwd text.split( )[1] if self.users.get(state[user]) pwd: state[authed] True conn.sendall(bOK Logged in\r\n) else: conn.sendall(b-ERR bad password\r\n) else: conn.sendall(b-ERR auth first\r\n) continue # 事务状态 if cmd STAT: mails self.mailboxes[state[user]] total sum(len(m) for m in mails) conn.sendall(fOK {len(mails)} {total}\r\n.encode()) elif cmd LIST: mails self.mailboxes[state[user]] resp fOK {len(mails)} messages\r\n for i, m in enumerate(mails, 1): resp f{i} {len(m)}\r\n resp .\r\n conn.sendall(resp.encode()) elif cmd RETR: idx int(text.split( )[1]) mails self.mailboxes[state[user]] if 1 idx len(mails): msg mails[idx - 1] resp OK message follows\r\n for l in msg.split(\r\n): if l.startswith(.): l . l resp l \r\n resp .\r\n conn.sendall(resp.encode()) else: conn.sendall(b-ERR no such message\r\n) elif cmd DELE: idx int(text.split( )[1]) state[deleted].add(idx) conn.sendall(bOK marked\r\n) elif cmd QUIT: # 真正删除标记的邮件 mails self.mailboxes[state[user]] self.mailboxes[state[user]] [m for i, m in enumerate(mails, 1) if i not in state[deleted]] conn.sendall(bOK bye\r\n) returndeleted集合记录要删除的邮件序号QUIT 时才真正从列表里移除。这个延迟删除的设计是 POP3 协议的要求也给了用户反悔的机会。STAT返回邮件数量和总字节数LIST返回每封邮件的序号和大小这些响应格式在 RFC 1939 里有明确定义客户端解析时依赖这些格式。3.4 客户端发信与收信的完整流程客户端不需要多线程按顺序发命令、读响应即可。发信时构造邮件头部收信时解析多行响应。import socket import base64 def send_mail(smtp_host, smtp_port, from_addr, to_addr, subject, body): s socket.socket(socket.AF_INET, socket.SOCK_STREAM) s.connect((smtp_host, smtp_port)) recv_line(s) # 220 send_cmd(s, fHELO client) send_cmd(s, fMAIL FROM:{from_addr}) send_cmd(s, fRCPT TO:{to_addr}) send_cmd(s, DATA) # 构造邮件内容中文主题需要 Base64 编码 subject_encoded base64.b64encode(subject.encode(utf-8)).decode() mail fSubject: ?utf-8?B?{subject_encoded}?\r\n mail fFrom: {from_addr}\r\nTo: {to_addr}\r\n\r\n mail body \r\n.\r\n s.sendall(mail.encode(utf-8)) recv_line(s) # 250 send_cmd(s, QUIT) s.close() def recv_line(s): 读取一行响应处理多行模式 data b while not data.endswith(b\r\n): data s.recv(1) return data.decode(utf-8).strip() def send_cmd(s, cmd): s.sendall((cmd \r\n).encode()) return recv_line(s)中文主题用?utf-8?B?编码是 MIME 标准的要求不编码的话服务器可能拒绝或者客户端显示乱码。正文如果包含非 ASCII 字符也需要指定Content-Type: text/plain; charsetutf-8否则收件人看到的是乱码。这些细节在课设答辩时经常被问到。4. 避坑与排查那些让课设卡住一整天的坑4.1 邮件正文里的点号导致截断现象发送一封正文包含单独一行点号的邮件收件人收到的内容不完整点号之后的内容丢失。原因SMTP 和 POP3 都用单独一行点号表示数据结束正文里如果出现同样的行协议解析时会提前结束。解决发送时对以点开头的行前面再加一个点接收时做反向还原。这个转义逻辑在服务器和客户端都要实现缺一不可。4.2 多线程共享邮箱列表导致数据错乱现象两个客户端同时发信给同一个用户收件人 LIST 时邮件数量不对或者 RETR 时内容串了。原因多个线程同时修改mailboxes列表Python 的 list 操作不是原子的并发追加和读取会冲突。解决给邮箱操作加threading.Lock投递和读取时都先获取锁。课设规模下全局锁就够用不需要更细粒度的锁。self.lock threading.Lock() def deliver_mail(self, from_addr, rcpt_list, data_lines): with self.lock: for rcpt in rcpt_list: if rcpt in self.mailboxes: self.mailboxes[rcpt].append(\r\n.join(data_lines))4.3 客户端 recv 阻塞导致界面卡死现象客户端点击“收信”后界面无响应必须等服务器返回才能操作。原因socket 的recv默认是阻塞的如果服务器没有数据返回客户端线程会一直等。解决设置超时s.settimeout(5)或者在客户端用独立线程处理网络请求主线程负责界面刷新。课设如果做 GUI建议用后者。4.4 中文编码不一致导致乱码现象发信时主题和正文正常收信后显示乱码。原因发送端用 UTF-8 编码接收端用 GBK 解码或者邮件头部没有声明字符集。解决统一用 UTF-8邮件头部加Content-Type: text/plain; charsetutf-8主题用 MIME 编码。服务器存储时按字节存不要做解码再编码。4.5 端口被占用导致服务器启动失败现象运行服务器脚本报OSError: [Errno 98] Address already in use。原因上次运行的服务器进程没有正常退出端口还在 TIME_WAIT 状态。解决设置SO_REUSEADDR或者换一个端口。调试时养成用lsof -i :2525检查端口占用的习惯。5. 进阶技巧用 Wireshark 验证协议交互与答辩演示课设答辩时老师最常问的是“你怎么证明你的实现符合协议”。光跑通不够最好能抓包展示。Wireshark 可以直接解析 SMTP 和 POP3把每个命令和响应码都列出来比看日志直观得多。具体做法服务器和客户端都跑在本地Wireshark 选回环接口lo过滤条件用tcp.port 2525 || tcp.port 1100。然后走一遍发信和收信流程抓到的包会按协议分层展示。重点看几个地方SMTP 的 DATA 阶段是否以\r\n.\r\n结束POP3 的 RETR 响应是否以\r\n.\r\n结束响应码是否和 RFC 一致。如果抓包发现响应码不对比如 MAIL FROM 返回了 550先检查发件人地址格式是否带了尖括号。如果 DATA 阶段服务器没返回 354检查上一条 RCPT TO 是否成功。这些排查思路在答辩时能体现你对协议的理解深度。另一个加分项是做一个简单的命令行客户端支持send和recv两个命令演示时直接输入参数就能跑。代码不用复杂但交互要流畅。我一般会让学生提前准备一个演示脚本把发信、收信、删除邮件三个操作串起来避免现场手忙脚乱。最后说一个我自己的习惯每次改完服务器代码先用 Telnet 手动走一遍协议确认响应码和格式没问题再跑客户端。Telnet 是最可靠的“后悔药”能帮你快速定位是服务器的问题还是客户端的问题。希望帮到你。本文还有配套的精品资源点击获取 基于Python Socket的SMTP与POP3模拟邮件系统课程设计实战
简介这是一份面向高校计算机网络课程设计场景的模拟邮件系统完整项目源码适合正在完成课程作业或希望理解邮件收发底层协议的学生与开发者。项目基于SMTP与POP3协议实现用户注册登录、资料编辑、发信、收件箱查看及来信回复等核心功能并支持与公网邮箱绑定后完成真实邮件投递。技术栈采用MVC架构以Maven组织工程整合Servlet、JSP、MyBatis与JavaMail配置好数据库即可运行便于快速搭建与二次开发。资源包共58个文件约119KB包含12个Java源文件、12个class编译文件、10个XML配置、6个JSP页面及CSS、properties等资源覆盖后端逻辑、前端展示与工程配置各层面。目前已有3493人学习下载可作为课程设计参考方案帮助读者理清邮件协议交互流程、掌握JavaMail调用方式与SSM整合思路并借鉴其目录结构与配置组织方式。1. 模拟邮件系统从一封邮件的旅程看懂 SMTP 与 POP3很多人做计算机网络课程设计时第一反应是抓包分析或者写个聊天室但真正能把 SMTP 和 POP3 讲清楚的人不多。模拟邮件系统这个题目看起来简单——发邮件、收邮件但背后涉及 TCP 连接管理、应用层协议状态机、Base64 编码、MIME 格式、多线程并发是一个能同时考察网络编程和协议理解的综合题。我带过几届课设发现大部分同学卡在三个地方一是把 SMTP 和 POP3 混在一起写二是不知道邮件正文为什么要编码三是服务器端用单线程导致只能服务一个客户端。这篇笔记按实际做一遍的顺序展开从协议原理到代码落地再到调试时那些让人抓狂的坑目标是让你能照着跑通一个可演示、可答辩的版本。适合正在做计算机网络课程设计、需要交一个能跑的系统并且要讲清楚原理的读者。2. 先把协议聊明白SMTP 发信和 POP3 收信到底怎么配合2.1 SMTP 的会话流程与命令集SMTP 是推协议客户端主动把邮件推给服务器。一次典型的会话从 TCP 三次握手开始然后服务器发 220 问候客户端依次发 HELO/EHLO、MAIL FROM、RCPT TO、DATA最后 QUIT 断开。每个命令都有对应的数字响应码比如 250 表示成功354 表示可以开始发数据550 表示邮箱不可用。这里有个容易翻车的地方很多人以为 SMTP 只负责发信实际上它也能做中继但课程设计里我们只实现最简模型——客户端直连服务器服务器把邮件存到本地用户目录。命令交互是纯文本的用 Telnet 就能手动走一遍这是调试时最有效的验证手段。# 用 Telnet 手动走一遍 SMTP 会话验证服务器响应是否正确 telnet 127.0.0.1 25 # 服务器返回 220 mail.local SMTP Ready HELO test # 返回 250 Hello test MAIL FROM:alicelocal # 返回 250 OK RCPT TO:boblocal # 返回 250 OK DATA # 返回 354 End data with CRLF.CRLF Subject: test mail From: alicelocal To: boblocal Hello Bob, this is a test. . # 返回 250 Message accepted QUIT # 返回 221 Bye上面这段交互里DATA 之后的单独一行点号表示邮件内容结束这是 SMTP 的约定。如果正文里恰好有一行只有一个点需要写成两个点来转义这个细节在解析时经常被忽略导致邮件内容被截断。2.2 POP3 的三种状态与收信命令POP3 是拉协议客户端主动去服务器取邮件。会话分三个状态认证状态USER/PASS、事务状态STAT、LIST、RETR、DELE、更新状态QUIT 后真正删除标记的邮件。和 SMTP 不同POP3 在 QUIT 之前删除的邮件只是打标记QUIT 时才真正落盘删除。课程设计里常见的做法是服务器为每个用户维护一个 maildrop 文件每封邮件用特定分隔符隔开。客户端 RETR 时按邮件序号返回整封邮件内容包括头部和正文。这里要注意POP3 的响应是多行模式第一行是 OK后续行是数据最后以单独的点号结束。# POP3 服务器端处理 RETR 命令的核心逻辑 def handle_retr(self, msg_num): 返回指定序号的邮件内容多行模式以 . 结束 if msg_num 1 or msg_num len(self.maildrop): return -ERR no such message\r\n msg self.maildrop[msg_num - 1] # 多行响应OK 开头逐行发送最后单独一行点号 response OK message follows\r\n for line in msg.split(\r\n): # 如果正文行以点开头需要转义为两个点 if line.startswith(.): line . line response line \r\n response .\r\n return response这段代码里maildrop是一个列表每个元素是一封完整的邮件字符串。转义逻辑是 POP3 的硬性要求不处理的话客户端会把正文里的点号误认为结束标志。参数msg_num从 1 开始和 LIST 命令返回的序号对应。2.3 为什么选 Python socket 而不是现成库课程设计的核心是理解协议不是调库。用 Python 的socket模块从零实现能让你看清每个字节的收发过程。如果直接用smtplib和poplib虽然能跑通但答辩时老师问一句“SMTP 的 DATA 阶段怎么判断结束”就答不上来了。我一般会建议学生先用 socket 写一个最小版本服务器监听 25 和 110 端口收到连接后 fork 一个线程处理按状态机解析命令。客户端也手写用 socket 连上去发命令、读响应。这样整个流程完全可控调试时可以在任意位置打日志。提示课程设计环境里 25 端口可能被系统占用或需要管理员权限建议改用 2525 和 1100 这类高位端口客户端连接时指定端口即可。3. 动手写代码服务器端状态机与客户端交互实现3.1 服务器主循环与多线程模型服务器要同时处理 SMTP 和 POP3 两种协议最简单的做法是开两个监听端口每个端口一个独立线程 accept收到连接后再为每个客户端开一个处理线程。这样结构清晰也方便分别调试。import socket import threading class MailServer: def __init__(self, smtp_port2525, pop3_port1100): self.smtp_port smtp_port self.pop3_port pop3_port self.users {alice: 123456, bob: 123456} self.mailboxes {alice: [], bob: []} def start(self): # SMTP 监听线程 smtp_sock socket.socket(socket.AF_INET, socket.SOCK_STREAM) smtp_sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) smtp_sock.bind((0.0.0.0, self.smtp_port)) smtp_sock.listen(5) threading.Thread(targetself.accept_loop, args(smtp_sock, SMTP), daemonTrue).start() # POP3 监听线程 pop3_sock socket.socket(socket.AF_INET, socket.SOCK_STREAM) pop3_sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) pop3_sock.bind((0.0.0.0, self.pop3_port)) pop3_sock.listen(5) threading.Thread(targetself.accept_loop, args(pop3_sock, POP3), daemonTrue).start() def accept_loop(self, sock, proto): while True: conn, addr sock.accept() threading.Thread(targetself.handle_client, args(conn, proto), daemonTrue).start()SO_REUSEADDR是为了避免服务器重启时端口被 TIME_WAIT 状态占用。daemonTrue让线程随主进程退出调试时不会残留。每个连接一个线程的模型在课设规模下完全够用但要注意共享数据mailboxes的线程安全后面会讲怎么加锁。3.2 SMTP 会话的状态机实现SMTP 处理函数需要维护一个会话状态当前是否已 HELO、发件人是谁、收件人列表、是否在 DATA 阶段。用简单的字符串判断就能实现但状态多了容易乱建议用字典显式记录。def handle_smtp(self, conn): conn.sendall(b220 mail.local SMTP Ready\r\n) state {helo: False, from: None, rcpt: [], data_mode: False} buffer b while True: chunk conn.recv(4096) if not chunk: break buffer chunk while b\r\n in buffer: line, buffer buffer.split(b\r\n, 1) text line.decode(utf-8, errorsignore).strip() if state[data_mode]: if text .: # 邮件结束投递到收件人邮箱 self.deliver_mail(state[from], state[rcpt], state[data_lines]) conn.sendall(b250 Message accepted\r\n) state.update({data_mode: False, from: None, rcpt: [], data_lines: []}) else: state[data_lines].append(text) continue # 命令解析 cmd text.split( )[0].upper() if cmd HELO or cmd EHLO: state[helo] True conn.sendall(b250 Hello\r\n) elif cmd MAIL: state[from] text.split(:)[-1].strip() conn.sendall(b250 OK\r\n) elif cmd RCPT: state[rcpt].append(text.split(:)[-1].strip()) conn.sendall(b250 OK\r\n) elif cmd DATA: state[data_mode] True state[data_lines] [] conn.sendall(b354 End data with CRLF.CRLF\r\n) elif cmd QUIT: conn.sendall(b221 Bye\r\n) return else: conn.sendall(b500 Unknown command\r\n)这里用buffer累积数据再按\r\n切分是为了处理 TCP 粘包。如果直接recv一次就解析客户端快速发送多条命令时可能读到半条。data_lines在 DATA 阶段收集正文遇到单独的点号就投递。投递函数deliver_mail需要给每个收件人的邮箱列表追加邮件这里要加锁。3.3 POP3 认证与邮件读取POP3 比 SMTP 简单但要注意认证状态和事务状态的切换。USER 和 PASS 都正确后才进入事务状态之后才能执行 STAT、LIST、RETR、DELE。def handle_pop3(self, conn): conn.sendall(bOK POP3 server ready\r\n) state {user: None, authed: False, deleted: set()} buffer b while True: chunk conn.recv(4096) if not chunk: break buffer chunk while b\r\n in buffer: line, buffer buffer.split(b\r\n, 1) text line.decode(utf-8, errorsignore).strip() cmd text.split( )[0].upper() if not state[authed]: if cmd USER: state[user] text.split( )[1] conn.sendall(bOK\r\n) elif cmd PASS: pwd text.split( )[1] if self.users.get(state[user]) pwd: state[authed] True conn.sendall(bOK Logged in\r\n) else: conn.sendall(b-ERR bad password\r\n) else: conn.sendall(b-ERR auth first\r\n) continue # 事务状态 if cmd STAT: mails self.mailboxes[state[user]] total sum(len(m) for m in mails) conn.sendall(fOK {len(mails)} {total}\r\n.encode()) elif cmd LIST: mails self.mailboxes[state[user]] resp fOK {len(mails)} messages\r\n for i, m in enumerate(mails, 1): resp f{i} {len(m)}\r\n resp .\r\n conn.sendall(resp.encode()) elif cmd RETR: idx int(text.split( )[1]) mails self.mailboxes[state[user]] if 1 idx len(mails): msg mails[idx - 1] resp OK message follows\r\n for l in msg.split(\r\n): if l.startswith(.): l . l resp l \r\n resp .\r\n conn.sendall(resp.encode()) else: conn.sendall(b-ERR no such message\r\n) elif cmd DELE: idx int(text.split( )[1]) state[deleted].add(idx) conn.sendall(bOK marked\r\n) elif cmd QUIT: # 真正删除标记的邮件 mails self.mailboxes[state[user]] self.mailboxes[state[user]] [m for i, m in enumerate(mails, 1) if i not in state[deleted]] conn.sendall(bOK bye\r\n) returndeleted集合记录要删除的邮件序号QUIT 时才真正从列表里移除。这个延迟删除的设计是 POP3 协议的要求也给了用户反悔的机会。STAT返回邮件数量和总字节数LIST返回每封邮件的序号和大小这些响应格式在 RFC 1939 里有明确定义客户端解析时依赖这些格式。3.4 客户端发信与收信的完整流程客户端不需要多线程按顺序发命令、读响应即可。发信时构造邮件头部收信时解析多行响应。import socket import base64 def send_mail(smtp_host, smtp_port, from_addr, to_addr, subject, body): s socket.socket(socket.AF_INET, socket.SOCK_STREAM) s.connect((smtp_host, smtp_port)) recv_line(s) # 220 send_cmd(s, fHELO client) send_cmd(s, fMAIL FROM:{from_addr}) send_cmd(s, fRCPT TO:{to_addr}) send_cmd(s, DATA) # 构造邮件内容中文主题需要 Base64 编码 subject_encoded base64.b64encode(subject.encode(utf-8)).decode() mail fSubject: ?utf-8?B?{subject_encoded}?\r\n mail fFrom: {from_addr}\r\nTo: {to_addr}\r\n\r\n mail body \r\n.\r\n s.sendall(mail.encode(utf-8)) recv_line(s) # 250 send_cmd(s, QUIT) s.close() def recv_line(s): 读取一行响应处理多行模式 data b while not data.endswith(b\r\n): data s.recv(1) return data.decode(utf-8).strip() def send_cmd(s, cmd): s.sendall((cmd \r\n).encode()) return recv_line(s)中文主题用?utf-8?B?编码是 MIME 标准的要求不编码的话服务器可能拒绝或者客户端显示乱码。正文如果包含非 ASCII 字符也需要指定Content-Type: text/plain; charsetutf-8否则收件人看到的是乱码。这些细节在课设答辩时经常被问到。4. 避坑与排查那些让课设卡住一整天的坑4.1 邮件正文里的点号导致截断现象发送一封正文包含单独一行点号的邮件收件人收到的内容不完整点号之后的内容丢失。原因SMTP 和 POP3 都用单独一行点号表示数据结束正文里如果出现同样的行协议解析时会提前结束。解决发送时对以点开头的行前面再加一个点接收时做反向还原。这个转义逻辑在服务器和客户端都要实现缺一不可。4.2 多线程共享邮箱列表导致数据错乱现象两个客户端同时发信给同一个用户收件人 LIST 时邮件数量不对或者 RETR 时内容串了。原因多个线程同时修改mailboxes列表Python 的 list 操作不是原子的并发追加和读取会冲突。解决给邮箱操作加threading.Lock投递和读取时都先获取锁。课设规模下全局锁就够用不需要更细粒度的锁。self.lock threading.Lock() def deliver_mail(self, from_addr, rcpt_list, data_lines): with self.lock: for rcpt in rcpt_list: if rcpt in self.mailboxes: self.mailboxes[rcpt].append(\r\n.join(data_lines))4.3 客户端 recv 阻塞导致界面卡死现象客户端点击“收信”后界面无响应必须等服务器返回才能操作。原因socket 的recv默认是阻塞的如果服务器没有数据返回客户端线程会一直等。解决设置超时s.settimeout(5)或者在客户端用独立线程处理网络请求主线程负责界面刷新。课设如果做 GUI建议用后者。4.4 中文编码不一致导致乱码现象发信时主题和正文正常收信后显示乱码。原因发送端用 UTF-8 编码接收端用 GBK 解码或者邮件头部没有声明字符集。解决统一用 UTF-8邮件头部加Content-Type: text/plain; charsetutf-8主题用 MIME 编码。服务器存储时按字节存不要做解码再编码。4.5 端口被占用导致服务器启动失败现象运行服务器脚本报OSError: [Errno 98] Address already in use。原因上次运行的服务器进程没有正常退出端口还在 TIME_WAIT 状态。解决设置SO_REUSEADDR或者换一个端口。调试时养成用lsof -i :2525检查端口占用的习惯。5. 进阶技巧用 Wireshark 验证协议交互与答辩演示课设答辩时老师最常问的是“你怎么证明你的实现符合协议”。光跑通不够最好能抓包展示。Wireshark 可以直接解析 SMTP 和 POP3把每个命令和响应码都列出来比看日志直观得多。具体做法服务器和客户端都跑在本地Wireshark 选回环接口lo过滤条件用tcp.port 2525 || tcp.port 1100。然后走一遍发信和收信流程抓到的包会按协议分层展示。重点看几个地方SMTP 的 DATA 阶段是否以\r\n.\r\n结束POP3 的 RETR 响应是否以\r\n.\r\n结束响应码是否和 RFC 一致。如果抓包发现响应码不对比如 MAIL FROM 返回了 550先检查发件人地址格式是否带了尖括号。如果 DATA 阶段服务器没返回 354检查上一条 RCPT TO 是否成功。这些排查思路在答辩时能体现你对协议的理解深度。另一个加分项是做一个简单的命令行客户端支持send和recv两个命令演示时直接输入参数就能跑。代码不用复杂但交互要流畅。我一般会让学生提前准备一个演示脚本把发信、收信、删除邮件三个操作串起来避免现场手忙脚乱。最后说一个我自己的习惯每次改完服务器代码先用 Telnet 手动走一遍协议确认响应码和格式没问题再跑客户端。Telnet 是最可靠的“后悔药”能帮你快速定位是服务器的问题还是客户端的问题。希望帮到你。本文还有配套的精品资源点击获取