简介这是一份面向高校计算机网络课程设计场景的模拟邮件系统项目源码适合正在完成课程大作业或希望理解邮件收发底层协议的学生与开发者。项目基于SMTP与POP3协议实现用户注册登录、资料编辑、发信、收件箱查看与来信回复等完整流程并支持与公网邮箱绑定后实际收发邮件帮助读者把抽象的协议理论落到可运行的系统上。压缩包共58个文件约119KB以12个java源文件与12个class编译文件为核心配合10个xml配置、6个jsp页面、3个css样式及properties等资源采用Maven构建整体结构清晰。技术栈为ServletJSPMyBatisJavaMail的MVC实现配置好数据库即可运行便于二次修改与调试。目前已有3493人学习下载可作为课程设计参考方案也能帮助读者梳理邮件协议交互流程与项目分层组织方式。1. 从一封发不出去的邮件说起这套 SMTPPOP3 模拟系统到底能跑通什么很多人做计算机网络课程设计时卡住的地方不是不会写 Java而是邮件协议本身太玄学——本地localhost发信成功换成真实邮箱就 535 认证失败收件箱能显示列表点开正文却是乱码。这套基于 SMTPPOP3 的模拟邮件系统就是冲着这些具体问题来的它用 ServletJSPMyBatisJavaMail 把注册登录—绑定公网邮箱—发信—收信—回复整条链路串起来Maven 管理依赖配好数据库就能跑。适合正在做计算机网络课程设计、想找一个能讲清协议交互又真能演示收发过程的同学也适合想快速摸一遍 JavaMail API 边界的开发者。下面按它是什么—怎么搭—坑在哪—怎么验的顺序拆开讲。2. 拆开 WebChat.rarMVC 分层与 JavaMail 协议栈怎么对上2.1 目录结构里藏着什么拿到WebChat.rar解压后第一眼看到的是标准 Eclipse Maven Web 工程的样子。src/main/java放 Servlet 和业务逻辑src/main/webapp放 JSP 页面src/test是测试代码target是编译输出.settings和.classpath、.project是 Eclipse 工程元数据pom.xml才是真正决定这个项目能不能跑起来的东西。很多人解压后直接往 IDE 里拖结果一堆红叉问题基本都出在没先看pom.xml里的依赖版本和 JDK 编译级别。这个工程用的是m2e-wtp插件说明它原本就是在 Eclipse 里用 Maven 构建的 Web 项目。.settings目录下那几个文件——org.eclipse.wst.common.project.facet.core.xml定义了 Web 模块版本和 Java 版本org.eclipse.jdt.core.prefs管编译合规级别org.eclipse.wst.validation.prefs管校验规则。如果你用 IDEA 打开这些 Eclipse 专属配置会被忽略需要手动在 Project Structure 里把 Facet 和 Artifact 配回来否则部署到 Tomcat 时会报找不到 Web 模块。2.2 SMTP 发信与 POP3 收信在代码里怎么落地邮件协议这块项目用的是 JavaMailjavax.mail。SMTP 负责发POP3 负责收两者在代码里是两套独立的 Session 配置。发信时用Transport.send()走 SMTP收信时用Store走 POP3 连到收件服务器拉取邮件列表。这里有个关键点项目要求用户登录并与公网邮箱绑定后才能收发意味着系统本身不搭建邮件服务器而是把公网邮箱比如 QQ 邮箱、163 邮箱的 SMTP/POP3 服务当作后端。所以配置里必须填对三样东西——邮箱地址、授权码不是登录密码、服务器地址和端口。常见做法是在src/main/resources下放一个mail.properties把不同邮箱服务商的 SMTP/POP3 地址和端口做成可配置项。下面这段是我一般会先写出来验证连通性的最小代码// 发信核心SMTP 会话配置 Properties props new Properties(); props.put(mail.smtp.host, smtp.qq.com); // SMTP 服务器地址 props.put(mail.smtp.port, 465); // SSL 端口QQ 邮箱用 465 props.put(mail.smtp.auth, true); // 必须开启认证 props.put(mail.smtp.ssl.enable, true); // 465 端口必须走 SSL props.put(mail.smtp.connectiontimeout, 5000); // 连接超时避免卡死 props.put(mail.smtp.timeout, 5000); // 读超时 Session session Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(yourqq.com, 授权码); // 注意不是登录密码 } }); // 构造并发送 MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(yourqq.com)); message.setRecipient(Message.RecipientType.TO, new InternetAddress(target163.com)); message.setSubject(测试主题); message.setText(测试正文); Transport.send(message);这段代码里mail.smtp.ssl.enable和端口是绑定的465 端口走 SSL587 端口走 STARTTLS25 端口明文多数公网邮箱已封。参数填错一个要么连不上要么认证失败。connectiontimeout和timeout这两个参数很多人不写结果网络不通时线程一直挂着页面转圈到超时调试时根本不知道卡在哪一步。收信侧用 POP3 拉取// 收信核心POP3 会话配置 Properties popProps new Properties(); popProps.put(mail.pop3.host, pop.qq.com); popProps.put(mail.pop3.port, 995); // POP3 SSL 端口 popProps.put(mail.pop3.ssl.enable, true); Session popSession Session.getInstance(popProps); Store store popSession.getStore(pop3); store.connect(pop.qq.com, yourqq.com, 授权码); Folder folder store.getFolder(INBOX); folder.open(Folder.READ_ONLY); Message[] messages folder.getMessages(); // 拿到邮件数组 // 遍历 messages取 subject、from、content 存库或展示 folder.close(false); store.close();POP3 的坑在于getContent()返回的类型不固定——纯文本返回String带附件的返回MultipartHTML 邮件返回String但内容是标签。项目里查看收件箱功能如果只做message.getContent().toString()遇到 Multipart 直接抛异常。稳妥做法是先判断instanceof Multipart再递归解析 BodyPart。2.3 数据库表与 MyBatis 映射用户注册信息、收件箱列表、发件记录这些都要落库。按摘要描述系统有注册、登录、编辑信息、发信、收信、回复六个功能点对应至少三张表user用户信息邮箱绑定、mail_send发件记录、mail_receive收件记录。MyBatis 的 mapper XML 放在src/main/resources/mapper下pom.xml里引入mybatis和mysql-connector-java依赖。建表时注意mail_receive的正文字段用TEXT而不是VARCHAR(255)邮件正文很容易超长。另外user表里存邮箱授权码的字段课程设计阶段可以明文但至少要在注释里写清楚生产环境需加密。3. 从零跑起来环境、数据库、部署三步走3.1 环境准备与依赖确认先看pom.xml里的 JDK 编译级别。这个工程用m2e-wtp大概率是 Java 8 或 11。Tomcat 版本要和 Servlet 版本对上——如果pom.xml里javax.servlet-api是 3.1Tomcat 用 8.5 或 9如果是 4.0Tomcat 用 9 或 10。版本对不上启动就报ClassNotFoundException或NoSuchMethodError。MySQL 用 5.7 或 8.0 都行但mysql-connector-java的版本要匹配5.7 用 5.1.x 驱动8.0 用 8.0.x 驱动。驱动类名也不一样5.x 是com.mysql.jdbc.Driver8.x 是com.mysql.cj.jdbc.Driver。这个细节在mybatis-config.xml或jdbc.properties里改。3.2 数据库初始化建库建表这一步我一般直接写一个init.sql放src/main/resources下方便反复重建CREATE DATABASE webchat DEFAULT CHARACTER SET utf8mb4; USE webchat; CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, email VARCHAR(100), -- 绑定的公网邮箱 auth_code VARCHAR(100), -- 邮箱授权码 smtp_host VARCHAR(100), -- 如 smtp.qq.com pop3_host VARCHAR(100) -- 如 pop.qq.com ); CREATE TABLE mail_receive ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, from_addr VARCHAR(100), subject VARCHAR(255), content TEXT, -- 正文用 TEXT避免截断 receive_time DATETIME, FOREIGN KEY (user_id) REFERENCES user(id) );utf8mb4是为了兼容 emoji 和特殊字符邮件正文里出现这些的概率不低。auth_code字段长度给 100QQ 邮箱授权码是 16 位163 是 16 位留足余量。3.3 部署与首次运行Maven 打包用mvn clean package生成target/WebChat.war丢进 Tomcat 的webapps目录启动 Tomcat。访问http://localhost:8080/WebChat/应该能看到登录页。注册一个账号登录后在编辑信息里填入你的公网邮箱和授权码保存。然后试着给自己发一封邮件——如果收件箱能看到说明 SMTP 和 POP3 都通了。这里有个顺序问题必须先绑定邮箱再发信因为发信时要从user表里读 SMTP 配置。如果没绑定就点发信代码里取到 null直接 NPE。项目摘要里写用户登录并与公网邮箱绑定后才发信就是这个原因。4. 避坑与排查授权码、端口、乱码、超时四类翻车现场4.1 535 认证失败授权码不是登录密码现象发信时抛AuthenticationFailedException: 535 Error: authentication failed。原因代码里填的是邮箱登录密码但 QQ、163 等公网邮箱的 SMTP/POP3 服务要求用授权码。授权码需要在邮箱网页版的设置里单独开启 SMTP 服务后生成和登录密码是两回事。解决登录邮箱网页版 → 设置 → 账户 → 开启 SMTP/POP3 服务 → 生成授权码 → 把授权码填到系统的编辑信息里。注意授权码只显示一次没存下来就得重新生成。4.2 连接超时端口和 SSL 配置不匹配现象Transport.send()卡住十几秒后抛MessagingException: Could not connect to SMTP host。原因端口和加密方式对不上。465 必须配mail.smtp.ssl.enabletrue587 必须配mail.smtp.starttls.enabletrue25 端口明文但多数公网邮箱已封禁。三者混用就连不上。解决QQ 邮箱用 465SSL163 邮箱用 465SSL 或 994POP3 SSL。改完配置后先用telnet smtp.qq.com 465测一下端口通不通通了再跑代码。4.3 正文乱码字符集没统一现象收件箱里邮件正文显示成ä½ å¥½这类乱码。原因三个环节的字符集没对齐——JSP 页面pageEncoding、数据库连接 URL 的characterEncoding、JavaMail 的setText()默认字符集。任何一处用了 ISO-8859-1中文就乱。解决JSP 页面头部写% page contentTypetext/html;charsetUTF-8 %JDBC URL 加?useUnicodetruecharacterEncodingutf8发信时用message.setText(content, UTF-8)显式指定。收信解析时MimeUtility.decodeText()处理编码后的主题。4.4 收件箱为空POP3 拉取后没存库现象绑定邮箱成功发信也成功但收件箱页面一直空白。原因POP3 的folder.getMessages()拿到的是服务器上的邮件如果代码只遍历展示而没有INSERT到mail_receive表刷新页面后数据就没了。或者folder.open(Folder.READ_ONLY)之后没关下次连接被服务器拒绝。解决在遍历messages的循环里每封邮件解析完就写库用user_id关联当前登录用户。folder.close(false)和store.close()放在finally块里确保异常时也能释放连接。5. 进阶验证用协议日志确认 SMTP/POP3 交互真的走通了课程设计答辩时老师大概率会问你怎么证明 SMTP 和 POP3 真的在工作。光看页面收发成功不够得把协议交互过程打出来。JavaMail 支持开Session的 debug 模式Session session Session.getInstance(props, authenticator); session.setDebug(true); // 开启后控制台会打印完整的 SMTP 命令交互 session.setDebugOut(System.out);开启后控制台会输出类似EHLO、AUTH LOGIN、MAIL FROM、RCPT TO、DATA、QUIT这样的命令序列这就是 SMTP 协议握手和发信的全过程。POP3 侧同理store连接后会打印USER、PASS、STAT、LIST、RETR、QUIT。把这些日志截下来放进课程设计报告比任何文字描述都有说服力。再进一步可以用 Wireshark 抓本地回环或网卡流量过滤smtp或pop3端口看 TCP 三次握手之后的应用层报文。不过注意如果走了 SSL抓到的内容是加密的只能看到握手阶段。想看明文得临时用 25 端口如果邮箱还支持或者用本地搭建的测试邮件服务器。我自己的习惯是每次改完邮件相关配置先跑一遍 debug 模式确认命令序列完整、没有AUTH失败或RETR超时再去看页面。从那以后我每次调邮件功能都强制走一遍setDebug(true)省得在页面上瞎猜。希望这套拆解能帮你把课程设计顺利跑通。本文还有配套的精品资源点击获取