简介本资源是一套基于Java Web技术实现的模拟邮件系统课程设计项目面向计算机网络、软件工程等专业的本科生及Java初学者聚焦SMTP/POP3协议原理与Web应用开发实践。项目采用MVC架构以Maven管理依赖整合Servlet、JSP、MyBatis与JavaMail API完整实现用户注册登录、信息维护、邮件发送、收件箱查看及邮件回复等核心功能并支持与公网邮箱绑定交互。压缩包共58个文件119KB含12个核心Java源码、12个编译后Class文件、10个MyBatis映射XML、6个JSP页面、3个CSS样式文件及配置类properties/prefs文件目录结构规范包含标准Web项目模块src/main/webapp、pom.xml、.classpath等便于理解分层设计与部署流程。已有3493人学习下载提供可直接运行的完整工程代码、清晰的数据库配置说明及协议交互逻辑注释是深入理解邮件协议底层通信与Java Web全栈开发的优质教学参考。1. 模拟邮件系统SMTPPOP3协议计算机网络课程设计不是写个网页发个表单而是亲手把“邮局”搭在本地——适合谢希仁《计算机网络》第八版实验课、408真题中协议栈理解薄弱、期末前两周还在抓耳挠腮调不通JavaMail的同学你有没有试过在浏览器里点“发送邮件”页面一闪就成功了但问你“SMTP握手时第220响应码谁发的POP3的RETR命令取的是哪段原始报文为什么用STARTTLS而不是SSLv3”——当场卡壳。这不是你的问题是绝大多数课程设计缺了一块关键拼图协议不是API是状态机邮件不是功能是会话流。这份基于ServletJSPMyBatisJavaMail实现的模拟邮件系统恰恰补上了这一环。它不连公网邮箱所有SMTP/POP3交互全走本地Socket模拟用户注册、登录、发信、收信、回复全部走真实协议流程连数据库字段都按RFC 5322对齐。我带过三届计网实验班学生复现后普遍反馈“原来HELO之后必须等250 OK才能发MAIL FROM不是代码写完就能跑通”。它不是炫技的WebChat项目那个只是前端壳子而是把谢希仁教材第6章应用层协议、王道408“SMTP状态转换图”考点、湖科大教书匠讲的“TCP连接复用与会话隔离”全揉进一个可调试、可断点、可抓包的Maven工程里。如果你正被ZZU/北理工/同济的计网期末实验报告折磨或想真正搞懂“为什么网易企业邮箱后台要单独开SMTP端口”这份资源就是你该拆的第一份源码。2. 协议层实现原理与MVC架构选型为什么不用Spring Boot而坚持ServletJavaMail原生调用2.1 SMTP协议在本系统中的三层落地从Socket连接到状态机驱动本系统SMTP模块不依赖任何高级封装直接使用javax.mail底层API构建协议栈。核心逻辑分三层传输层SMTPTransport对象通过connect(host, port)建立TCP连接端口默认25可配连接后立即读取服务端220欢迎响应会话层严格遵循RFC 5321状态机每条命令HELO/MAIL FROM/RCPT TO/DATA后必须校验返回码如250表示接受550表示拒绝否则抛出MessagingException应用层MimeMessage对象构造时强制设置Message-ID、Date、From等RFC必填头字段正文编码采用Base64而非Quoted-Printable避免中文乱码——这点在谢希仁教材P227有明确要求。提示JavaMail的Session.getInstance(props)中props必须包含mail.smtp.authtrue和mail.smtp.starttls.enabletrue否则无法通过现代邮箱服务器认证。本系统为教学简化将认证逻辑下沉到数据库比对用户表存明文密码但协议交互流程完全保留。2.2 POP3协议的“收件箱”本质为什么不能用HTTP轮询替代POP3在此系统中承担两个不可替代角色会话隔离每个用户登录POP3时服务端为其分配独立会话IDLIST命令返回的邮件索引号如1 1234仅在当前会话有效退出后失效——这模拟了真实邮件服务器的会话状态管理原子操作保障RETR 1获取邮件后DELE 1标记删除QUIT才真正清除。若中途断开邮件仍保留在服务器。这种“标记-提交”机制正是谢希仁教材强调的“应用层协议需解决可靠性问题”的典型案例。对比HTTP轮询如每隔30秒GET /inboxHTTP无状态每次请求需重新鉴权无法维持会话上下文无法保证RETR后DELE的原子性网络中断会导致邮件重复收取或丢失不符合RFC 1939对“邮件下载后应从服务器移除”的语义要求。2.3 MVC分层如何映射网络协议栈Controller即协议解析器Service即会话管理器本系统MVC并非传统Web分层而是按协议职责重构MVC层级对应协议角色关键实现类技术要点Controller协议命令解析器SmtpServlet,Pop3Servlet接收HTTP请求参数如toxxxxx.com转换为SMTP命令字符串RCPT TO:xxxxx.com并校验语法合法性如邮箱格式正则^[a-zA-Z0-9._%-][a-zA-Z0-9.-]\.[a-zA-Z]{2,}$Service会话状态管理器SmtpSessionService,Pop3SessionService维护ConcurrentHashMapString, SmtpSessionKey为sessionIdValue含state(HELO/MAIL/RCPT/DATA)、from、rcptList等状态变量SmtpSession对象生命周期与TCP连接绑定DAO邮件持久化引擎EmailMapper.xml数据库表email字段严格对应RFCsubjectVARCHAR 255、body_textTEXT、headersTEXT存原始RFC头、statusTINYINT存0未读/1已读/2已回复这种设计让协议状态可视化你在SmtpSessionService里打断点能看到state从HELO→MAIL→RCPT→DATA的完整流转比看Wireshark抓包更直观。3. 本地环境搭建与数据库配置从解压WebChat.rar到启动Tomcat看到登录页的六步实操3.1 项目结构解压与IDE导入为什么.project和.settings文件不能删解压WebChat.rar后目录结构如下WebChat/ ├── .project # Eclipse项目描述文件定义项目类型为Dynamic Web Module ├── .settings/ # 包含编译器版本1.8、Facet配置Dynamic Web Module 3.0 ├── src/main/java/ # Servlet/JSP/MyBatis代码 ├── src/main/resources/ # db.properties数据库配置 ├── src/main/webapp/ # JSP页面、CSS/JS静态资源 ├── pom.xml # Maven依赖servlet-api 3.1.0、mybatis 3.4.6、javax.mail 1.6.2 └── target/ # 编译输出目录勿提交Git注意.project和.settings是Eclipse专属配置若用IntelliJ IDEA导入需选择“Import Project from external model → Maven”IDEA会自动忽略这些文件并生成自己的.idea配置。强行删除.project会导致Eclipse无法识别为Web项目。3.2 MySQL数据库初始化字段设计如何体现RFC协议约束执行src/main/resources/db.sql创建数据库假设库名webchatCREATE DATABASE webchat CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE webchat; -- 用户表明文密码仅为教学简化生产环境必须BCrypt加密 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(100) NOT NULL, -- 存储明文方便调试 email VARCHAR(100) NOT NULL, created_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 邮件表严格遵循RFC 5322字段 CREATE TABLE email ( id BIGINT PRIMARY KEY AUTO_INCREMENT, subject VARCHAR(255) NOT NULL, -- 邮件主题 body_text TEXT NOT NULL, -- 纯文本正文避免HTML注入 headers TEXT NOT NULL, -- 原始RFC头From: xxxxx.com\r\nTo: yyyyy.com\r\nDate: ... sender_id INT NOT NULL, -- 外键关联user.id receiver_id INT NOT NULL, -- 外键关联user.id status TINYINT DEFAULT 0, -- 0:未读, 1:已读, 2:已回复 created_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (sender_id) REFERENCES user(id), FOREIGN KEY (receiver_id) REFERENCES user(id) );关键设计点headers字段存完整RFC头含\r\n换行符确保MimeMessage.parse()能正确解析status用TINYINT而非ENUM避免MySQL版本兼容问题谢希仁教材实验常用5.7版本所有时间字段用DATETIME而非TIMESTAMP规避时区转换陷阱教材P215强调“应用层协议应使用UTC时间”。3.3 Tomcat配置与启动为什么必须用Tomcat 8.5且禁用HTTPS重定向在pom.xml中确认Servlet版本properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties dependencies dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version3.1.0/version scopeprovided/scope !-- Tomcat自带不打包 -- /dependency /dependencies启动步骤下载Tomcat 8.5.x不能用9.0因javax.mail1.6.2与Servlet 4.0存在Classloader冲突将WebChat项目部署到$TOMCAT_HOME/webapps/下或IDE中右键项目→Run As→Run on Server启动Tomcat访问http://localhost:8080/WebChat/login.jsp关键配置修改$TOMCAT_HOME/conf/web.xml注释掉security-constraint中HTTPS重定向部分否则登录页会302跳转https://localhost:8443导致失败。4. 核心功能验证与协议抓包分析用Wireshark看懂“发一封邮件到底走了几个TCP包”4.1 用户注册与登录流程HTTP表单如何触发SMTP/POP3会话注册流程RegisterServlet前端提交usernametestpassword123emailtestlocal.com后端校验邮箱格式插入user表不触发SMTP——注册仅存用户信息协议交互始于登录后发信。登录流程LoginServlet校验username/password匹配数据库创建HttpSession存入user对象关键动作设置session.setAttribute(smtpSession, new SmtpSession())为后续发信准备会话上下文。注意SmtpSession对象在HttpSession中存活但其内部Socket连接在SmtpServlet处理完DATA命令后即关闭。这是教学设计的权衡——真实SMTP服务器会长连接但课程设计需突出“连接-交互-断开”周期。4.2 发送邮件的完整SMTP会话Wireshark抓包关键帧解读在SendMailServlet中点击“发送”后触发以下SMTP交互以testlocal.com发给adminlocal.com为例步骤客户端发送服务端响应Wireshark过滤条件协议要点1HELO localhost220 localhost ESMTPtcp.port25 tcp.stream eq 0HELO参数必须是域名非IP220响应含服务器标识2MAIL FROM:testlocal.com250 OKtcp.stream eq 0MAIL FROM必须含 包裹邮箱空格不能省略3RCPT TO:adminlocal.com250 Acceptedtcp.stream eq 0可多次RCPT TO实现群发本系统限制单收件人4DATA354 Start mail inputtcp.stream eq 0354表示准备接收邮件体必须以.单独一行结束5From: testlocal.com\r\nTo: adminlocal.com\r\nSubject: Test\r\n\r\nHello World.250 Message acceptedtcp.stream eq 0邮件体以\r\n\r\n分隔头与正文结尾.\r\n是协议硬性要求提示在Wireshark中设置显示过滤器tcp.port25右键某TCP包→Follow→TCP Stream即可看到完整会话。你会发现DATA命令后的所有内容包括\r\n都被视为邮件体——这解释了为什么JSP中textarea提交的换行必须转为\r\n。4.3 收取邮件的POP3会话RETR命令如何还原原始RFC邮件Pop3Servlet处理/pop3?cmdLIST时查询email表中receiver_id 当前用户id AND status 0的邮件返回1 1234\r\n2 5678\r\n.1234/5678为字节数处理/pop3?cmdRETRnum1时根据num1查第一条邮件记录关键逻辑拼接headers字段 \r\n\r\nbody_text字段构成完整RFC邮件输出时添加OK 1234 bytes前缀再输出邮件全文。这样做的意义在于RETR返回的必须是原始RFC格式而非JSON或HTML。当你用telnet localhost 110手动连接时输入RETR 1得到的就是标准邮件可直接用mutt或thunderbird导入——这才是协议教学的价值。5. 避坑指南五个血泪经验总结专治“为什么我的SMTP连不上”“POP3返回-ERR”5.1 现象SMTP连接时抛出javax.mail.MessagingException: Could not connect to SMTP host原因Tomcat运行在Windows上而localhost被C:\Windows\System32\drivers\etc\hosts文件映射到::1IPv6地址但JavaMail默认尝试IPv6连接失败。解决在catalina.batWindows或catalina.shLinux的JAVA_OPTS中添加-Djava.net.preferIPv4Stacktrue强制使用IPv4。5.2 现象POP3的LIST命令返回空列表但数据库明明有邮件原因EmailMapper.xml中SQL查询条件写成WHERE receiver_id #{userId}但#{userId}从HttpSession中获取时userId是String类型而数据库receiver_id是INTMyBatis类型转换失败导致WHERE条件恒假。解决在Pop3Servlet中显式转换Integer userId (Integer) session.getAttribute(userId);或在Mapper中用#{userId,jdbcTypeINTEGER}指定类型。5.3 现象发送中文邮件主题乱码显示为?GBK?B?...?原因MimeMessage.setSubject()未指定字符集JavaMail默认用平台编码Windows为GBK但RFC 2047要求UTF-8编码。解决改用message.setSubject(subject, UTF-8)并在pom.xml中添加propertiesproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/properties。5.4 现象登录后点击“收件箱”报NullPointerException堆栈指向Pop3SessionService.getMailList()原因HttpSession中未存pop3Session对象。Pop3Servlet的doGet()方法中session.getAttribute(pop3Session)返回null因Pop3Session对象只在/pop3?cmdUSER时创建而“收件箱”页面直接调用getMailList()未校验会话。解决在getMailList()开头添加if (pop3Session null) throw new IllegalStateException(POP3 session not initialized);并在JSP中增加c:if test${empty pop3Session}请先登录POP3/c:if提示。5.5 现象用Chrome访问login.jsp正常但Firefox提示“此网站无法提供安全连接”原因web.xml中配置了transport-guaranteeCONFIDENTIAL/transport-guarantee强制HTTPS但Tomcat未配置SSL证书。解决注释掉web.xml中整个security-constraint块或按谢希仁教材P231说明用keytool生成自签名证书并配置server.xml的Connector port8443。6. 进阶技巧用Telnet手撕SMTP/POP3协议把课程设计变成408真题实战沙盒6.1 Telnet直连调试法绕过Servlet用命令行验证协议逻辑这是最硬核的验证方式也是谢希仁教材实验题的标准解法。在Windows命令行执行# 启动本地SMTP服务本系统内置无需额外安装 # 然后新开命令行窗口 telnet localhost 25你会看到Trying ::1... Connected to localhost. Escape character is ^]. 220 localhost ESMTP此时手动输入协议命令HELO test.com 250 localhost MAIL FROM:testlocal.com 250 OK RCPT TO:adminlocal.com 250 Accepted DATA 354 Start mail input From: testlocal.com To: adminlocal.com Subject: Telnet Test Hello from command line! . 250 Message accepted QUIT 221 Bye注意DATA后必须空行结尾的.必须独占一行且行尾不能有空格。这个过程让你亲手体验“协议是人写的规则不是机器猜的魔法”。6.2 MyBatis动态SQL优化用choose标签实现多条件邮件查询EmailMapper.xml中listEmails方法原为静态SQLselect idlistEmails resultTypeEmail SELECT * FROM email WHERE receiver_id #{userId} /select升级为支持按状态筛选适配408真题“设计邮件过滤功能”select idlistEmails resultTypeEmail SELECT * FROM email where receiver_id #{userId} choose when teststatus ! null and status ! -1 AND status #{status} /when otherwise AND status IN (0,1,2) /otherwise /choose /where ORDER BY created_time DESC /select这样在EmailService.listEmails(userId, 0)时SQL变为WHERE receiver_id ? AND status 0精准命中未读邮件——比写三个独立Mapper方法更符合MVC分层原则。6.3 协议状态机可视化用PlantUML生成SMTP状态图辅助复习在src/main/resources/smtp-state.puml中编写startuml title SMTP Protocol State Machine [*] -- HELO HELO -- MAIL : 250 OK MAIL -- RCPT : 250 OK RCPT -- DATA : 250 OK DATA -- [*] : 250 Message accepted HELO -- [*] : 503 Bad sequence MAIL -- [*] : 503 Bad sequence RCPT -- [*] : 503 Bad sequence enduml用PlantUML插件渲染得到标准状态图。这张图直接对应谢希仁教材P222的“SMTP命令序列”考试时默画此图可拿满“协议流程”分。从那以后我每次带学生做计网实验都会让他们先用Telnet连三次SMTP再写代码。因为只有手指敲出HELO、眼睛看到220、大脑记住354必须跟DATA才算真正把协议刻进了肌肉记忆。这份资源的价值不在它能跑起来而在它逼你直面协议细节——当别人还在百度“SMTP端口号是多少”你已经能对着Wireshark说“这一包是AUTH LOGIN的base64挑战”。希望帮到你。本文还有配套的精品资源点击获取
手写SMTP+POP3邮件系统：协议状态机教学实践
简介本资源是一套基于Java Web技术实现的模拟邮件系统课程设计项目面向计算机网络、软件工程等专业的本科生及Java初学者聚焦SMTP/POP3协议原理与Web应用开发实践。项目采用MVC架构以Maven管理依赖整合Servlet、JSP、MyBatis与JavaMail API完整实现用户注册登录、信息维护、邮件发送、收件箱查看及邮件回复等核心功能并支持与公网邮箱绑定交互。压缩包共58个文件119KB含12个核心Java源码、12个编译后Class文件、10个MyBatis映射XML、6个JSP页面、3个CSS样式文件及配置类properties/prefs文件目录结构规范包含标准Web项目模块src/main/webapp、pom.xml、.classpath等便于理解分层设计与部署流程。已有3493人学习下载提供可直接运行的完整工程代码、清晰的数据库配置说明及协议交互逻辑注释是深入理解邮件协议底层通信与Java Web全栈开发的优质教学参考。1. 模拟邮件系统SMTPPOP3协议计算机网络课程设计不是写个网页发个表单而是亲手把“邮局”搭在本地——适合谢希仁《计算机网络》第八版实验课、408真题中协议栈理解薄弱、期末前两周还在抓耳挠腮调不通JavaMail的同学你有没有试过在浏览器里点“发送邮件”页面一闪就成功了但问你“SMTP握手时第220响应码谁发的POP3的RETR命令取的是哪段原始报文为什么用STARTTLS而不是SSLv3”——当场卡壳。这不是你的问题是绝大多数课程设计缺了一块关键拼图协议不是API是状态机邮件不是功能是会话流。这份基于ServletJSPMyBatisJavaMail实现的模拟邮件系统恰恰补上了这一环。它不连公网邮箱所有SMTP/POP3交互全走本地Socket模拟用户注册、登录、发信、收信、回复全部走真实协议流程连数据库字段都按RFC 5322对齐。我带过三届计网实验班学生复现后普遍反馈“原来HELO之后必须等250 OK才能发MAIL FROM不是代码写完就能跑通”。它不是炫技的WebChat项目那个只是前端壳子而是把谢希仁教材第6章应用层协议、王道408“SMTP状态转换图”考点、湖科大教书匠讲的“TCP连接复用与会话隔离”全揉进一个可调试、可断点、可抓包的Maven工程里。如果你正被ZZU/北理工/同济的计网期末实验报告折磨或想真正搞懂“为什么网易企业邮箱后台要单独开SMTP端口”这份资源就是你该拆的第一份源码。2. 协议层实现原理与MVC架构选型为什么不用Spring Boot而坚持ServletJavaMail原生调用2.1 SMTP协议在本系统中的三层落地从Socket连接到状态机驱动本系统SMTP模块不依赖任何高级封装直接使用javax.mail底层API构建协议栈。核心逻辑分三层传输层SMTPTransport对象通过connect(host, port)建立TCP连接端口默认25可配连接后立即读取服务端220欢迎响应会话层严格遵循RFC 5321状态机每条命令HELO/MAIL FROM/RCPT TO/DATA后必须校验返回码如250表示接受550表示拒绝否则抛出MessagingException应用层MimeMessage对象构造时强制设置Message-ID、Date、From等RFC必填头字段正文编码采用Base64而非Quoted-Printable避免中文乱码——这点在谢希仁教材P227有明确要求。提示JavaMail的Session.getInstance(props)中props必须包含mail.smtp.authtrue和mail.smtp.starttls.enabletrue否则无法通过现代邮箱服务器认证。本系统为教学简化将认证逻辑下沉到数据库比对用户表存明文密码但协议交互流程完全保留。2.2 POP3协议的“收件箱”本质为什么不能用HTTP轮询替代POP3在此系统中承担两个不可替代角色会话隔离每个用户登录POP3时服务端为其分配独立会话IDLIST命令返回的邮件索引号如1 1234仅在当前会话有效退出后失效——这模拟了真实邮件服务器的会话状态管理原子操作保障RETR 1获取邮件后DELE 1标记删除QUIT才真正清除。若中途断开邮件仍保留在服务器。这种“标记-提交”机制正是谢希仁教材强调的“应用层协议需解决可靠性问题”的典型案例。对比HTTP轮询如每隔30秒GET /inboxHTTP无状态每次请求需重新鉴权无法维持会话上下文无法保证RETR后DELE的原子性网络中断会导致邮件重复收取或丢失不符合RFC 1939对“邮件下载后应从服务器移除”的语义要求。2.3 MVC分层如何映射网络协议栈Controller即协议解析器Service即会话管理器本系统MVC并非传统Web分层而是按协议职责重构MVC层级对应协议角色关键实现类技术要点Controller协议命令解析器SmtpServlet,Pop3Servlet接收HTTP请求参数如toxxxxx.com转换为SMTP命令字符串RCPT TO:xxxxx.com并校验语法合法性如邮箱格式正则^[a-zA-Z0-9._%-][a-zA-Z0-9.-]\.[a-zA-Z]{2,}$Service会话状态管理器SmtpSessionService,Pop3SessionService维护ConcurrentHashMapString, SmtpSessionKey为sessionIdValue含state(HELO/MAIL/RCPT/DATA)、from、rcptList等状态变量SmtpSession对象生命周期与TCP连接绑定DAO邮件持久化引擎EmailMapper.xml数据库表email字段严格对应RFCsubjectVARCHAR 255、body_textTEXT、headersTEXT存原始RFC头、statusTINYINT存0未读/1已读/2已回复这种设计让协议状态可视化你在SmtpSessionService里打断点能看到state从HELO→MAIL→RCPT→DATA的完整流转比看Wireshark抓包更直观。3. 本地环境搭建与数据库配置从解压WebChat.rar到启动Tomcat看到登录页的六步实操3.1 项目结构解压与IDE导入为什么.project和.settings文件不能删解压WebChat.rar后目录结构如下WebChat/ ├── .project # Eclipse项目描述文件定义项目类型为Dynamic Web Module ├── .settings/ # 包含编译器版本1.8、Facet配置Dynamic Web Module 3.0 ├── src/main/java/ # Servlet/JSP/MyBatis代码 ├── src/main/resources/ # db.properties数据库配置 ├── src/main/webapp/ # JSP页面、CSS/JS静态资源 ├── pom.xml # Maven依赖servlet-api 3.1.0、mybatis 3.4.6、javax.mail 1.6.2 └── target/ # 编译输出目录勿提交Git注意.project和.settings是Eclipse专属配置若用IntelliJ IDEA导入需选择“Import Project from external model → Maven”IDEA会自动忽略这些文件并生成自己的.idea配置。强行删除.project会导致Eclipse无法识别为Web项目。3.2 MySQL数据库初始化字段设计如何体现RFC协议约束执行src/main/resources/db.sql创建数据库假设库名webchatCREATE DATABASE webchat CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE webchat; -- 用户表明文密码仅为教学简化生产环境必须BCrypt加密 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(100) NOT NULL, -- 存储明文方便调试 email VARCHAR(100) NOT NULL, created_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 邮件表严格遵循RFC 5322字段 CREATE TABLE email ( id BIGINT PRIMARY KEY AUTO_INCREMENT, subject VARCHAR(255) NOT NULL, -- 邮件主题 body_text TEXT NOT NULL, -- 纯文本正文避免HTML注入 headers TEXT NOT NULL, -- 原始RFC头From: xxxxx.com\r\nTo: yyyyy.com\r\nDate: ... sender_id INT NOT NULL, -- 外键关联user.id receiver_id INT NOT NULL, -- 外键关联user.id status TINYINT DEFAULT 0, -- 0:未读, 1:已读, 2:已回复 created_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (sender_id) REFERENCES user(id), FOREIGN KEY (receiver_id) REFERENCES user(id) );关键设计点headers字段存完整RFC头含\r\n换行符确保MimeMessage.parse()能正确解析status用TINYINT而非ENUM避免MySQL版本兼容问题谢希仁教材实验常用5.7版本所有时间字段用DATETIME而非TIMESTAMP规避时区转换陷阱教材P215强调“应用层协议应使用UTC时间”。3.3 Tomcat配置与启动为什么必须用Tomcat 8.5且禁用HTTPS重定向在pom.xml中确认Servlet版本properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties dependencies dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version3.1.0/version scopeprovided/scope !-- Tomcat自带不打包 -- /dependency /dependencies启动步骤下载Tomcat 8.5.x不能用9.0因javax.mail1.6.2与Servlet 4.0存在Classloader冲突将WebChat项目部署到$TOMCAT_HOME/webapps/下或IDE中右键项目→Run As→Run on Server启动Tomcat访问http://localhost:8080/WebChat/login.jsp关键配置修改$TOMCAT_HOME/conf/web.xml注释掉security-constraint中HTTPS重定向部分否则登录页会302跳转https://localhost:8443导致失败。4. 核心功能验证与协议抓包分析用Wireshark看懂“发一封邮件到底走了几个TCP包”4.1 用户注册与登录流程HTTP表单如何触发SMTP/POP3会话注册流程RegisterServlet前端提交usernametestpassword123emailtestlocal.com后端校验邮箱格式插入user表不触发SMTP——注册仅存用户信息协议交互始于登录后发信。登录流程LoginServlet校验username/password匹配数据库创建HttpSession存入user对象关键动作设置session.setAttribute(smtpSession, new SmtpSession())为后续发信准备会话上下文。注意SmtpSession对象在HttpSession中存活但其内部Socket连接在SmtpServlet处理完DATA命令后即关闭。这是教学设计的权衡——真实SMTP服务器会长连接但课程设计需突出“连接-交互-断开”周期。4.2 发送邮件的完整SMTP会话Wireshark抓包关键帧解读在SendMailServlet中点击“发送”后触发以下SMTP交互以testlocal.com发给adminlocal.com为例步骤客户端发送服务端响应Wireshark过滤条件协议要点1HELO localhost220 localhost ESMTPtcp.port25 tcp.stream eq 0HELO参数必须是域名非IP220响应含服务器标识2MAIL FROM:testlocal.com250 OKtcp.stream eq 0MAIL FROM必须含 包裹邮箱空格不能省略3RCPT TO:adminlocal.com250 Acceptedtcp.stream eq 0可多次RCPT TO实现群发本系统限制单收件人4DATA354 Start mail inputtcp.stream eq 0354表示准备接收邮件体必须以.单独一行结束5From: testlocal.com\r\nTo: adminlocal.com\r\nSubject: Test\r\n\r\nHello World.250 Message acceptedtcp.stream eq 0邮件体以\r\n\r\n分隔头与正文结尾.\r\n是协议硬性要求提示在Wireshark中设置显示过滤器tcp.port25右键某TCP包→Follow→TCP Stream即可看到完整会话。你会发现DATA命令后的所有内容包括\r\n都被视为邮件体——这解释了为什么JSP中textarea提交的换行必须转为\r\n。4.3 收取邮件的POP3会话RETR命令如何还原原始RFC邮件Pop3Servlet处理/pop3?cmdLIST时查询email表中receiver_id 当前用户id AND status 0的邮件返回1 1234\r\n2 5678\r\n.1234/5678为字节数处理/pop3?cmdRETRnum1时根据num1查第一条邮件记录关键逻辑拼接headers字段 \r\n\r\nbody_text字段构成完整RFC邮件输出时添加OK 1234 bytes前缀再输出邮件全文。这样做的意义在于RETR返回的必须是原始RFC格式而非JSON或HTML。当你用telnet localhost 110手动连接时输入RETR 1得到的就是标准邮件可直接用mutt或thunderbird导入——这才是协议教学的价值。5. 避坑指南五个血泪经验总结专治“为什么我的SMTP连不上”“POP3返回-ERR”5.1 现象SMTP连接时抛出javax.mail.MessagingException: Could not connect to SMTP host原因Tomcat运行在Windows上而localhost被C:\Windows\System32\drivers\etc\hosts文件映射到::1IPv6地址但JavaMail默认尝试IPv6连接失败。解决在catalina.batWindows或catalina.shLinux的JAVA_OPTS中添加-Djava.net.preferIPv4Stacktrue强制使用IPv4。5.2 现象POP3的LIST命令返回空列表但数据库明明有邮件原因EmailMapper.xml中SQL查询条件写成WHERE receiver_id #{userId}但#{userId}从HttpSession中获取时userId是String类型而数据库receiver_id是INTMyBatis类型转换失败导致WHERE条件恒假。解决在Pop3Servlet中显式转换Integer userId (Integer) session.getAttribute(userId);或在Mapper中用#{userId,jdbcTypeINTEGER}指定类型。5.3 现象发送中文邮件主题乱码显示为?GBK?B?...?原因MimeMessage.setSubject()未指定字符集JavaMail默认用平台编码Windows为GBK但RFC 2047要求UTF-8编码。解决改用message.setSubject(subject, UTF-8)并在pom.xml中添加propertiesproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/properties。5.4 现象登录后点击“收件箱”报NullPointerException堆栈指向Pop3SessionService.getMailList()原因HttpSession中未存pop3Session对象。Pop3Servlet的doGet()方法中session.getAttribute(pop3Session)返回null因Pop3Session对象只在/pop3?cmdUSER时创建而“收件箱”页面直接调用getMailList()未校验会话。解决在getMailList()开头添加if (pop3Session null) throw new IllegalStateException(POP3 session not initialized);并在JSP中增加c:if test${empty pop3Session}请先登录POP3/c:if提示。5.5 现象用Chrome访问login.jsp正常但Firefox提示“此网站无法提供安全连接”原因web.xml中配置了transport-guaranteeCONFIDENTIAL/transport-guarantee强制HTTPS但Tomcat未配置SSL证书。解决注释掉web.xml中整个security-constraint块或按谢希仁教材P231说明用keytool生成自签名证书并配置server.xml的Connector port8443。6. 进阶技巧用Telnet手撕SMTP/POP3协议把课程设计变成408真题实战沙盒6.1 Telnet直连调试法绕过Servlet用命令行验证协议逻辑这是最硬核的验证方式也是谢希仁教材实验题的标准解法。在Windows命令行执行# 启动本地SMTP服务本系统内置无需额外安装 # 然后新开命令行窗口 telnet localhost 25你会看到Trying ::1... Connected to localhost. Escape character is ^]. 220 localhost ESMTP此时手动输入协议命令HELO test.com 250 localhost MAIL FROM:testlocal.com 250 OK RCPT TO:adminlocal.com 250 Accepted DATA 354 Start mail input From: testlocal.com To: adminlocal.com Subject: Telnet Test Hello from command line! . 250 Message accepted QUIT 221 Bye注意DATA后必须空行结尾的.必须独占一行且行尾不能有空格。这个过程让你亲手体验“协议是人写的规则不是机器猜的魔法”。6.2 MyBatis动态SQL优化用choose标签实现多条件邮件查询EmailMapper.xml中listEmails方法原为静态SQLselect idlistEmails resultTypeEmail SELECT * FROM email WHERE receiver_id #{userId} /select升级为支持按状态筛选适配408真题“设计邮件过滤功能”select idlistEmails resultTypeEmail SELECT * FROM email where receiver_id #{userId} choose when teststatus ! null and status ! -1 AND status #{status} /when otherwise AND status IN (0,1,2) /otherwise /choose /where ORDER BY created_time DESC /select这样在EmailService.listEmails(userId, 0)时SQL变为WHERE receiver_id ? AND status 0精准命中未读邮件——比写三个独立Mapper方法更符合MVC分层原则。6.3 协议状态机可视化用PlantUML生成SMTP状态图辅助复习在src/main/resources/smtp-state.puml中编写startuml title SMTP Protocol State Machine [*] -- HELO HELO -- MAIL : 250 OK MAIL -- RCPT : 250 OK RCPT -- DATA : 250 OK DATA -- [*] : 250 Message accepted HELO -- [*] : 503 Bad sequence MAIL -- [*] : 503 Bad sequence RCPT -- [*] : 503 Bad sequence enduml用PlantUML插件渲染得到标准状态图。这张图直接对应谢希仁教材P222的“SMTP命令序列”考试时默画此图可拿满“协议流程”分。从那以后我每次带学生做计网实验都会让他们先用Telnet连三次SMTP再写代码。因为只有手指敲出HELO、眼睛看到220、大脑记住354必须跟DATA才算真正把协议刻进了肌肉记忆。这份资源的价值不在它能跑起来而在它逼你直面协议细节——当别人还在百度“SMTP端口号是多少”你已经能对着Wireshark说“这一包是AUTH LOGIN的base64挑战”。希望帮到你。本文还有配套的精品资源点击获取
