简介：面向计算机相关专业毕业生的Java邮件收发系统毕业设计资料包，内含项目报告、开题报告、任务书、外文翻译、文献综述和答辩PPT等全套文档，覆盖从选题到答辩的完整流程。系统设计基于JavaMail API实现，底层采用简单邮件传输协议（SMTP）完成邮件发送，使用邮局协议（POP）完成邮件接收；资料在阐述协议原理和JavaMail技术基础上，进一步说明了Java语言与Eclipse开发环境的安装配置，并分析了国内外现有邮件系统的优缺点。报告主体分为四个部分，依次说明系统开发意义与现状、相关协议及JavaMail API、开发工具与配置、邮件收发系统的具体实现，层次清晰，便于按阶段阅读和引用。压缩包为zip格式，大小约21.36MB，涵盖从开题到答辩所需的各类文档，结构明确。目前已有99人学习，适合正在筹备毕业设计的学生快速获取设计思路、模板与实现参考。
1. JavaMail邮件收发系统：先想清楚协议，再动手写代码
邮件收发系统是Java毕业设计里出现频率极高的题目，但很多人在协议、API实现和论文结构三个维度上顾此失彼。这套以SMTP发送、POP3接收为基础的JavaMail项目，恰好把三层都覆盖到了：协议层怎么选型、Session与Transport这套API抽象怎么用，以及开题报告、任务书、文献综述、外文翻译、项目报告和答辩PPT这份完整文档要怎么写。对准备毕设的学生来说，它是一份能直接复现的工程样板；对在职工程师来说，JavaMail的对象模型在今天的Spring Boot项目里依然以Jakarta Mail的形式存在，java基础和实际排错都用得上。
2. SMTP与POP3协议模型，以及JavaMail API的协议无关抽象
2.1 发送靠SMTP、接收靠POP3：两种协议的分工逻辑
SMTP（Simple Mail Transfer Protocol）解决的是把邮件推送到服务器的问题。客户端与服务器建立连接后，依次发送EHLO、MAIL FROM、RCPT TO、DATA等命令，服务器接力转发，最终投递到收件人的邮箱存储区。这个模型是push式的：只要地址有效，发件端不关心对端此刻是否在线。默认端口25面向MTA之间的中继，而客户端提交邮件走587端口，强制要求AUTH认证，防止服务器变成开放中继被垃圾邮件利用。手工模拟一次SMTP会话是理解协议最快的方式，telnet到25端口后输入下面这串命令即可：
EHLO example.com MAIL FROM:<sender@example.com> RCPT TO:<receiver@example.com> DATA Subject: protocol test hello, this is a raw smtp session . QUIT每行命令对应RFC 5321中的一个动词，最后以单独一行的英文句号结束DATA阶段。JavaMail的Transport对象在底层做的正是这几条命令的封装，只不过把认证、编码和异常处理都收进去了。毕设的项目报告里如果能把这段会话流程画清楚，协议选型部分基本就立住了。
POP3（Post Office Protocol version 3）解决的是把邮件从服务器拉回来的问题。客户端连接后通过USER/PASS认证，用LIST查看邮件列表、RETR取回指定邮件、DELE标记删除，最后QUIT。它是pull式模型，默认端口110，邮件取走后服务器端是否保留取决于客户端打开的读写模式。毕设选POP3而不是IMAP，是因为POP3无状态、命令简单，实现和讲解都更直观；IMAP虽然支持服务端文件夹同步，但语义更多，答辩时被追问的深度立刻上一个台阶。
| 维度 | SMTP | POP3 |
|---|---|---|
| 用途 | 发送邮件 | 接收邮件 |
| 默认端口 | 25 / 587（提交） | 110 |
| 工作模型 | 推送 push | 拉取 pull |
| 主要命令 | EHLO, MAIL FROM, RCPT TO, DATA | USER, PASS, LIST, RETR, DELE |
| 认证方式 | AUTH PLAIN / LOGIN | USER/PASS |
两种协议配合起来就是完整收发闭环。收发之间还有个隐层是MIME——SMTP传输层最早只支持7位ASCII，附件、非英文字符都要靠MIME编码成可传输格式，JavaMail里的MimeMessage、MimeBodyPart就是这层问题的对象化封装。这也是为什么项目从底层协议讲起，但落代码时直接用JavaMail API：协议是语义约定，API是协议无关的实现入口。
2.2 JavaMail API的抽象层次：从Session到Store
JavaMail不是JDK核心包，而是一套标准扩展，早期使用还必须配合JAF的activation.jar。它的设计思想是把协议差异挡在接口后面：应用程序只面向Session、Message、Transport、Store这几个抽象类编程，具体走SMTP还是POP3、要不要SSL，由Properties决定、由Provider解释。所谓"与协议无关的访问"，意思就是换协议不换代码结构。核心类的职责映射如下：
| 类/接口 | 职责 | 底层对应 |
|---|---|---|
| Session | 全局配置、认证入口 | 协议无关 |
| MimeMessage | 完整邮件对象（头+正文） | MIME格式 |
| Transport | 执行发送动作 | SMTP |
| Store | 连接收件服务器 | POP3/IMAP |
| Folder | 服务器上的邮件夹 | INBOX等 |
发送时不需要手写TCP连接和SMTP命令，把mail.smtp.host、mail.smtp.auth配置进Session，拿Transport调sendMessage即可。Transport的API签名不暴露协议语义，所以后来从smtp切到smtps、从pop3切到pop3s，代码主体几乎不动，只改properties前缀。
2.3 配置项前缀与调试开关
JavaMail约定协议相关配置统一以协议名开头：SMTP对应mail.smtp.，POP3对应mail.pop3.，IMAP对应mail.imap.*。同一个键换前缀就是另一套协议。常用键包括host、port、auth、ssl.enable、connectiontimeout和timeout。调试时打开session.setDebug(true)，控制台会打印客户端与服务器的完整命令交互，定位认证失败、连接重置极其有用。最简配置如下：
mail.smtp.host=smtp.qq.com mail.smtp.port=465 mail.smtp.auth=true mail.smtp.ssl.enable=true mail.smtp.connectiontimeout=10000 mail.smtp.timeout=10000connectiontimeout控制建立TCP连接的超时，timeout控制读写超时，单位都是毫秒。两个都建议显式设置，否则某些网络环境下默认值会让线程长时间挂起，这是新手最容易忽略的坑。
3. 发送模块落地：Session、Authenticator与MimeMessage的完整实现
3.1 环境准备：JavaMail与Eclipse的集成方式
毕设常用的组合是JDK 1.6/1.8加Eclipse加JavaMail 1.4.x。拿到配套源码后，把mail.jar和依赖的activation.jar复制到项目根目录，右键Build Path → Configure Build Path → Add JARs加入编译路径即可。Maven工程则常见做法是引入com.sun.mail:javax.mail:1.6.2，更新一点的项目用Jakarta Mail的org.eclipse.angus:jakarta.mail。JDK 9之后引入模块系统，直接把javax.mail放在classpath下会有模块访问警告，毕设阶段通常不影响运行，但值得知道原因：标准扩展包被移出了默认模块集。
一个高频报错是import javax.mail无法解析、cannot be resolved，十有八九是jar只拖进了项目目录而没有真正加到Build Path。检查方法很简单：在Package Explorer里展开Referenced Libraries，能看到mail.jar才算加上了。
3.2 第一封邮件：配置Properties并用Transport发送
发送邮件的最小实现如下，以QQ邮箱SMTP为例，换成自建服务器只改host和port：
import java.util.Properties; import javax.mail.*; import javax.mail.internet.*; public class MailSender { public static void main(String[] args) throws Exception { // 1. 配置SMTP参数：主机、端口、认证、SSL Properties props = new Properties(); props.put("mail.smtp.host", "smtp.qq.com"); props.put("mail.smtp.port", "465"); props.put("mail.smtp.auth", "true"); props.put("mail.smtp.ssl.enable", "true"); // 2. 创建Session，auth=true时Authenticator会被回调 Session session = Session.getInstance(props, new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { // 这里填邮箱授权码，不是登录密码 return new PasswordAuthentication("sender@qq.com", "your-auth-code"); } }); session.setDebug(true); // 打印SMTP交互过程 // 3. 构造MimeMessage：发件人、收件人、主题、正文 MimeMessage msg = new MimeMessage(session); msg.setFrom(new InternetAddress("sender@qq.com")); msg.setRecipients(Message.RecipientType.TO, InternetAddress.parse("receiver@example.com")); msg.setSubject("JavaMail 发送测试"); msg.setText("这是一封由 JavaMail 发送的测试邮件。"); // 4. 发送：静态方法内部自动创建Transport并关闭 Transport.send(msg); System.out.println("邮件发送完成"); } }逐段说明：Properties每一项都以mail.smtp.为前缀，auth=true触发Authenticator的回调，把账号和授权码填进去；普通SMTP服务器把ssl.enable去掉、端口换成25或587即可。setRecipients里除了TO还有CC、BCC对应抄送和密送；收件人多于一个时用逗号分隔的字符串直接丢给InternetAddress.parse()，它会自动拆分。
注意：写代码前先确认邮箱已开启SMTP/POP服务并生成授权码。用明文登录密码连接，绝大多数服务器直接返回535或454错误。
Transport.send(msg)是静态便捷方法，等价于先session.getTransport("smtp")，再connect、sendMessage、close。问题在于它每次发送都新建连接，邮件量小无所谓；批量发送时建议复用同一个Transport，免去反复握手。高频场景还应把3.1里的两个timeout参数加上，防止慢速服务器拖垮发送线程。
3.3 带HTML正文和附件的复合邮件：Multipart组合模式
业务里更常见的是HTML模板加附件的邮件。MimeMessage.setContent()可以接收一个MimeMultipart对象，内部再挂多个MimeBodyPart：正文一个part、附件各一个part：
// 复合邮件容器 MimeMultipart multipart = new MimeMultipart(); // 正文部分：HTML格式，必须显式指定字符集 MimeBodyPart htmlPart = new MimeBodyPart(); htmlPart.setContent("<h2>请查收周报</h2><p>本周数据见附件。</p>", "text/html;charset=UTF-8"); multipart.addBodyPart(htmlPart); // 附件部分：用DataHandler包装文件数据源 MimeBodyPart filePart = new MimeBodyPart(); filePart.setDataHandler(new DataHandler(new FileDataSource("C:/tmp/weekly-report.pdf"))); filePart.setFileName(MimeUtility.encodeText("周报-第12周.pdf", "UTF-8", null)); multipart.addBodyPart(filePart); msg.setContent(multipart); msg.saveChanges(); // 重新计算Content-Type和boundary等头字段setContent(String, String)的两个参数分别是内容和MIME类型，HTML正文要写成text/html;charset=UTF-8而不是text/plain。附件文件名含中文时直接setFileName，收件端可能解析成乱码，常见做法是先过MimeUtility.encodeText，参数分别是原始文件名、字符集和编码风格，传null表示按B编码处理。saveChanges()重新生成消息头，尤其是Content-Type里的boundary，漏掉它在部分邮箱客户端会导致正文或附件解析失败。
补充一个依赖层面的坑：FileDataSource来自JAF即activation.jar，JavaMail 1.4依赖它，JDK 9以上不再内置，需显式引入，或改用Jakarta Mail的新API。
3.4 发送前的收件人校验：MX记录预检
正式系统发送前最好先判断收件人域名是否存在，避免把邮件发给不存在的域，等SMTP服务器慢吞吞返回550。常见做法是查询DNS的MX记录：
Hashtable<String, String> env = new Hashtable<>(); env.put("java.naming.factory.initial", "com.sun.jndi.dns.DnsContextFactory"); DirContext ctx = new InitialDirContext(env); Attributes attrs = ctx.getAttributes("example.com", new String[] {"MX"}); System.out.println(attrs.get("MX"));InitialDirContext是JNDI的目录上下文，这里用它走DNS协议；getAttributes的第二个参数指定要查的记录类型。MX记录不存在，基本可以断定该域收不到信，提前拦截能省下一轮网络往返。这只是前置校验，最终结果仍以SMTP响应为准，比如550表示收件人被拒收，553表示发件人地址与认证账号不一致。
4. 收件模块落地：POP3 Store、Folder与Multipart递归解析
4.1 用Store和Folder拉取INBOX邮件
收件与发件共享Session，但连接对象不同：发件用Transport，收件用Store。Store对应协议连接层，Folder对应邮件夹。POP3收件完整代码如下：
import java.util.Properties; import javax.mail.*; public class MailReceiver { public static void main(String[] args) throws Exception { // 1. 配置POP3参数：QQ邮箱POP3端口995，必须SSL Properties props = new Properties(); props.put("mail.pop3.host", "pop.qq.com"); props.put("mail.pop3.port", "995"); props.put("mail.pop3.ssl.enable", "true"); Session session = Session.getInstance(props); session.setDebug(true); // 2. 建立连接，协议名通过getStore参数指定 Store store = session.getStore("pop3"); store.connect("pop.qq.com", "sender@qq.com", "your-auth-code"); // 3. 打开收件夹，只读方式 Folder folder = store.getFolder("INBOX"); folder.open(Folder.READ_ONLY); // 4. 拉取邮件，打印主题和发件人 Message[] messages = folder.getMessages(); for (Message m : messages) { System.out.println("主题: " + m.getSubject()); System.out.println("发件人: " + m.getFrom()[0]); System.out.println("收件时间: " + m.getReceivedDate()); System.out.println("---"); } folder.close(false); // false表示不删除已标记邮件 store.close(); } }getStore("pop3")里的字符串是协议标识，JavaMail据此在classpath里找对应的Provider。把协议名换成imap、host换成IMAP服务器，就能切到IMAP，这正是协议无关设计带来的好处。folder.open的第二个参数有READ_ONLY和READ_WRITE两个值：当前用READ_ONLY，不改服务器端状态；改成READ_WRITE后，对邮件调setFlag(Flags.Flag.DELETED, true)，close时才会真正删除，POP3的取走即删语义就是这么实现的。
| 协议 | 明文端口 | SSL/TLS端口 | 常见场景 |
|---|---|---|---|
| SMTP | 25 / 587 | 465 | 发信 |
| POP3 | 110 | 995 | 收信 |
| IMAP | 143 | 993 | 多端同步收信 |
注意getMessages()返回整个INBOX，收件箱上万封时内存会被一次性打满。常见做法是先getMessageCount()看总数，再用getMessages(start, end)分页拉取，比如一次只取最近50封。
4.2 递归解析Multipart：把正文和附件拆出来
发送时用Multipart组合了正文和附件，接收端遇到的是同样结构。麻烦在于Part.getContent()的返回类型不确定：纯文本直接返回String，复合邮件返回Multipart，而Multipart里的每个BodyPart又可能是复合的，所以解析必须递归：
private void parsePart(Part part) throws Exception { // 复合内容：递归进入每一子部分 if (part.isMimeType("multipart/*")) { Multipart mp = (Multipart) part.getContent(); for (int i = 0; i < mp.getCount(); i++) { parsePart(mp.getBodyPart(i)); } return; } // 纯文本或HTML正文：直接打印内容 if (part.isMimeType("text/*")) { System.out.println("正文: " + part.getContent().toString()); return; } // 附件：按文件名保存到本地 String fileName = part.getFileName(); if (fileName != null) { try (InputStream in = part.getInputStream()) { Files.copy(in, Paths.get("C:/tmp/" + fileName)); } } }isMimeType("multipart/*")是MIME通配匹配，比instanceof判断更贴近协议语义。getContent()对multipart返回Multipart对象，对叶子part返回String或InputStream，因此递归出口处要区分处理。附件分支用getFileName()非空作为判断条件，可以过滤掉内嵌图片这类Content-Disposition为inline的资源。如果文件名是= ?UTF-8?B?...?=形式的编码串，保存前先MimeUtility.decodeText还原，否则落盘文件名是一串乱码。
4.3 增量拉取：用UIDL避免重复下载
POP3协议本身没有游标概念，每次连接都是全量状态。要模拟增量，常见做法是利用UIDL命令给每封邮件分配稳定ID，本地记录已处理的ID并跳过重复项。JavaMail对应接口是UIDFolder：
if (folder instanceof UIDFolder) { UIDFolder uf = (UIDFolder) folder; Message[] messages = folder.getMessages(); for (Message m : messages) { long uid = uf.getUID(m); System.out.println("唯一标识: " + uid); } }getUID()返回值与POP3的UIDL一一对应，同一封邮件在同一服务器上UID恒定。把上次同步到的最大UID存进本地文件或数据库，下次只处理UID更大的邮件，就能做到不重不漏，这也是很多轻量邮件代理的实现思路，比按时间戳过滤稳妥得多，因为收件时间可以被某些场景影响，而UID不会变。
5. 毕业设计收尾：SSL配置、中文编码与材料组织技巧
5.1 三个高频错误与定位方法
| 异常或错误码 | 常见原因 | 处置 |
|---|---|---|
| javax.mail.AuthenticationFailedException | 授权码错误或未开启SMTP/POP服务 | 登录邮箱设置开启对应协议并重新生成授权码 |
| 553 Mail from must equal authorized user | 发件人地址与认证账号不一致 | setFrom必须与Authenticator里的账号保持一致 |
| 530 Must issue a STARTTLS command first | 服务器强制要求加密 | 设置mail.smtp.ssl.enable=true或starttls.enable=true |
提示：排错第一动作永远是打开session.setDebug(true)，先看S:开头的响应行，再动手改配置，比盲目改代码快得多。看到535基本是账号或授权码问题，553是地址不一致，554则可能是内容被反垃圾拦截。
5.2 中文编码与正文乱码的三个处理点
主题用msg.setSubject(subject, "UTF-8")，让JavaMail自动做RFC 2047编码；正文用setContent(html, "text/html;charset=UTF-8")，字符集跟在MIME类型后面；附件文件名用MimeUtility.encodeText包装后再setFileName，接收端用MimeUtility.decodeText还原。三点都命中后跨平台乱码基本消失。值得注意setSubject(String)不指定字符集时按平台默认编码处理，Windows下容易出现GBK编码主题，这是最常见的中文乱码源头。
5.3 项目报告材料组织的顺序
这套资源里的文档顺序本身是一条可行时间线：开题报告先定技术路线，SMTP/POP3选型、JavaMail API方案、Eclipse开发环境；任务书把功能拆成发送模块、接收模块、邮件解析模块和界面模块；文献综述和项目报告把RFC背景与代码实现对应起来。答辩按协议模型、类结构设计、发送流程、接收流程、测试结果的顺序讲，每页PPT配一张类图或交互时序，比堆大段代码更有说服力。外文翻译选MIME编码相关章节，把编码原理讲通，答辩时被追问的概率会低很多。
本文还有配套的精品资源，点击获取
