简介面向计算机相关专业毕业生的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两种协议的分工逻辑SMTPSimple Mail Transfer Protocol解决的是把邮件推送到服务器的问题。客户端与服务器建立连接后依次发送EHLO、MAIL FROM、RCPT TO、DATA等命令服务器接力转发最终投递到收件人的邮箱存储区。这个模型是push式的只要地址有效发件端不关心对端此刻是否在线。默认端口25面向MTA之间的中继而客户端提交邮件走587端口强制要求AUTH认证防止服务器变成开放中继被垃圾邮件利用。手工模拟一次SMTP会话是理解协议最快的方式telnet到25端口后输入下面这串命令即可EHLO example.com MAIL FROM:senderexample.com RCPT TO:receiverexample.com DATA Subject: protocol test hello, this is a raw smtp session . QUIT每行命令对应RFC 5321中的一个动词最后以单独一行的英文句号结束DATA阶段。JavaMail的Transport对象在底层做的正是这几条命令的封装只不过把认证、编码和异常处理都收进去了。毕设的项目报告里如果能把这段会话流程画清楚协议选型部分基本就立住了。POP3Post Office Protocol version 3解决的是把邮件从服务器拉回来的问题。客户端连接后通过USER/PASS认证用LIST查看邮件列表、RETR取回指定邮件、DELE标记删除最后QUIT。它是pull式模型默认端口110邮件取走后服务器端是否保留取决于客户端打开的读写模式。毕设选POP3而不是IMAP是因为POP3无状态、命令简单实现和讲解都更直观IMAP虽然支持服务端文件夹同步但语义更多答辩时被追问的深度立刻上一个台阶。维度SMTPPOP3用途发送邮件接收邮件默认端口25 / 587提交110工作模型推送 push拉取 pull主要命令EHLO, MAIL FROM, RCPT TO, DATAUSER, PASS, LIST, RETR, DELE认证方式AUTH PLAIN / LOGINUSER/PASS两种协议配合起来就是完整收发闭环。收发之间还有个隐层是MIME——SMTP传输层最早只支持7位ASCII附件、非英文字符都要靠MIME编码成可传输格式JavaMail里的MimeMessage、MimeBodyPart就是这层问题的对象化封装。这也是为什么项目从底层协议讲起但落代码时直接用JavaMail API协议是语义约定API是协议无关的实现入口。2.2 JavaMail API的抽象层次从Session到StoreJavaMail不是JDK核心包而是一套标准扩展早期使用还必须配合JAF的activation.jar。它的设计思想是把协议差异挡在接口后面应用程序只面向Session、Message、Transport、Store这几个抽象类编程具体走SMTP还是POP3、要不要SSL由Properties决定、由Provider解释。所谓与协议无关的访问意思就是换协议不换代码结构。核心类的职责映射如下类/接口职责底层对应Session全局配置、认证入口协议无关MimeMessage完整邮件对象头正文MIME格式Transport执行发送动作SMTPStore连接收件服务器POP3/IMAPFolder服务器上的邮件夹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.hostsmtp.qq.com mail.smtp.port465 mail.smtp.authtrue mail.smtp.ssl.enabletrue mail.smtp.connectiontimeout10000 mail.smtp.timeout10000connectiontimeout控制建立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和portimport 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. 创建Sessionauthtrue时Authenticator会被回调 Session session Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { // 这里填邮箱授权码不是登录密码 return new PasswordAuthentication(senderqq.com, your-auth-code); } }); session.setDebug(true); // 打印SMTP交互过程 // 3. 构造MimeMessage发件人、收件人、主题、正文 MimeMessage msg new MimeMessage(session); msg.setFrom(new InternetAddress(senderqq.com)); msg.setRecipients(Message.RecipientType.TO, InternetAddress.parse(receiverexample.com)); msg.setSubject(JavaMail 发送测试); msg.setText(这是一封由 JavaMail 发送的测试邮件。); // 4. 发送静态方法内部自动创建Transport并关闭 Transport.send(msg); System.out.println(邮件发送完成); } }逐段说明Properties每一项都以mail.smtp.为前缀authtrue触发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请查收周报/h2p本周数据见附件。/p, text/html;charsetUTF-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;charsetUTF-8而不是text/plain。附件文件名含中文时直接setFileName收件端可能解析成乱码常见做法是先过MimeUtility.encodeText参数分别是原始文件名、字符集和编码风格传null表示按B编码处理。saveChanges()重新生成消息头尤其是Content-Type里的boundary漏掉它在部分邮箱客户端会导致正文或附件解析失败。补充一个依赖层面的坑FileDataSource来自JAF即activation.jarJavaMail 1.4依赖它JDK 9以上不再内置需显式引入或改用Jakarta Mail的新API。3.4 发送前的收件人校验MX记录预检正式系统发送前最好先判断收件人域名是否存在避免把邮件发给不存在的域等SMTP服务器慢吞吞返回550。常见做法是查询DNS的MX记录HashtableString, 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, senderqq.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端口常见场景SMTP25 / 587465发信POP3110995收信IMAP143993多端同步收信注意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对应接口是UIDFolderif (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.enabletrue或starttls.enabletrue提示排错第一动作永远是打开session.setDebug(true)先看S:开头的响应行再动手改配置比盲目改代码快得多。看到535基本是账号或授权码问题553是地址不一致554则可能是内容被反垃圾拦截。5.2 中文编码与正文乱码的三个处理点主题用msg.setSubject(subject, UTF-8)让JavaMail自动做RFC 2047编码正文用setContent(html, text/html;charsetUTF-8)字符集跟在MIME类型后面附件文件名用MimeUtility.encodeText包装后再setFileName接收端用MimeUtility.decodeText还原。三点都命中后跨平台乱码基本消失。值得注意setSubject(String)不指定字符集时按平台默认编码处理Windows下容易出现GBK编码主题这是最常见的中文乱码源头。5.3 项目报告材料组织的顺序这套资源里的文档顺序本身是一条可行时间线开题报告先定技术路线SMTP/POP3选型、JavaMail API方案、Eclipse开发环境任务书把功能拆成发送模块、接收模块、邮件解析模块和界面模块文献综述和项目报告把RFC背景与代码实现对应起来。答辩按协议模型、类结构设计、发送流程、接收流程、测试结果的顺序讲每页PPT配一张类图或交互时序比堆大段代码更有说服力。外文翻译选MIME编码相关章节把编码原理讲通答辩时被追问的概率会低很多。本文还有配套的精品资源点击获取 
长河君 · 2026/9/16 1:18:02 · 阅读 1.2k JavaMail邮件收发系统实战：SMTP/POP3协议与Java实现详解
简介面向计算机相关专业毕业生的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两种协议的分工逻辑SMTPSimple Mail Transfer Protocol解决的是把邮件推送到服务器的问题。客户端与服务器建立连接后依次发送EHLO、MAIL FROM、RCPT TO、DATA等命令服务器接力转发最终投递到收件人的邮箱存储区。这个模型是push式的只要地址有效发件端不关心对端此刻是否在线。默认端口25面向MTA之间的中继而客户端提交邮件走587端口强制要求AUTH认证防止服务器变成开放中继被垃圾邮件利用。手工模拟一次SMTP会话是理解协议最快的方式telnet到25端口后输入下面这串命令即可EHLO example.com MAIL FROM:senderexample.com RCPT TO:receiverexample.com DATA Subject: protocol test hello, this is a raw smtp session . QUIT每行命令对应RFC 5321中的一个动词最后以单独一行的英文句号结束DATA阶段。JavaMail的Transport对象在底层做的正是这几条命令的封装只不过把认证、编码和异常处理都收进去了。毕设的项目报告里如果能把这段会话流程画清楚协议选型部分基本就立住了。POP3Post Office Protocol version 3解决的是把邮件从服务器拉回来的问题。客户端连接后通过USER/PASS认证用LIST查看邮件列表、RETR取回指定邮件、DELE标记删除最后QUIT。它是pull式模型默认端口110邮件取走后服务器端是否保留取决于客户端打开的读写模式。毕设选POP3而不是IMAP是因为POP3无状态、命令简单实现和讲解都更直观IMAP虽然支持服务端文件夹同步但语义更多答辩时被追问的深度立刻上一个台阶。维度SMTPPOP3用途发送邮件接收邮件默认端口25 / 587提交110工作模型推送 push拉取 pull主要命令EHLO, MAIL FROM, RCPT TO, DATAUSER, PASS, LIST, RETR, DELE认证方式AUTH PLAIN / LOGINUSER/PASS两种协议配合起来就是完整收发闭环。收发之间还有个隐层是MIME——SMTP传输层最早只支持7位ASCII附件、非英文字符都要靠MIME编码成可传输格式JavaMail里的MimeMessage、MimeBodyPart就是这层问题的对象化封装。这也是为什么项目从底层协议讲起但落代码时直接用JavaMail API协议是语义约定API是协议无关的实现入口。2.2 JavaMail API的抽象层次从Session到StoreJavaMail不是JDK核心包而是一套标准扩展早期使用还必须配合JAF的activation.jar。它的设计思想是把协议差异挡在接口后面应用程序只面向Session、Message、Transport、Store这几个抽象类编程具体走SMTP还是POP3、要不要SSL由Properties决定、由Provider解释。所谓与协议无关的访问意思就是换协议不换代码结构。核心类的职责映射如下类/接口职责底层对应Session全局配置、认证入口协议无关MimeMessage完整邮件对象头正文MIME格式Transport执行发送动作SMTPStore连接收件服务器POP3/IMAPFolder服务器上的邮件夹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.hostsmtp.qq.com mail.smtp.port465 mail.smtp.authtrue mail.smtp.ssl.enabletrue mail.smtp.connectiontimeout10000 mail.smtp.timeout10000connectiontimeout控制建立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和portimport 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. 创建Sessionauthtrue时Authenticator会被回调 Session session Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { // 这里填邮箱授权码不是登录密码 return new PasswordAuthentication(senderqq.com, your-auth-code); } }); session.setDebug(true); // 打印SMTP交互过程 // 3. 构造MimeMessage发件人、收件人、主题、正文 MimeMessage msg new MimeMessage(session); msg.setFrom(new InternetAddress(senderqq.com)); msg.setRecipients(Message.RecipientType.TO, InternetAddress.parse(receiverexample.com)); msg.setSubject(JavaMail 发送测试); msg.setText(这是一封由 JavaMail 发送的测试邮件。); // 4. 发送静态方法内部自动创建Transport并关闭 Transport.send(msg); System.out.println(邮件发送完成); } }逐段说明Properties每一项都以mail.smtp.为前缀authtrue触发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请查收周报/h2p本周数据见附件。/p, text/html;charsetUTF-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;charsetUTF-8而不是text/plain。附件文件名含中文时直接setFileName收件端可能解析成乱码常见做法是先过MimeUtility.encodeText参数分别是原始文件名、字符集和编码风格传null表示按B编码处理。saveChanges()重新生成消息头尤其是Content-Type里的boundary漏掉它在部分邮箱客户端会导致正文或附件解析失败。补充一个依赖层面的坑FileDataSource来自JAF即activation.jarJavaMail 1.4依赖它JDK 9以上不再内置需显式引入或改用Jakarta Mail的新API。3.4 发送前的收件人校验MX记录预检正式系统发送前最好先判断收件人域名是否存在避免把邮件发给不存在的域等SMTP服务器慢吞吞返回550。常见做法是查询DNS的MX记录HashtableString, 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, senderqq.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端口常见场景SMTP25 / 587465发信POP3110995收信IMAP143993多端同步收信注意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对应接口是UIDFolderif (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.enabletrue或starttls.enabletrue提示排错第一动作永远是打开session.setDebug(true)先看S:开头的响应行再动手改配置比盲目改代码快得多。看到535基本是账号或授权码问题553是地址不一致554则可能是内容被反垃圾拦截。5.2 中文编码与正文乱码的三个处理点主题用msg.setSubject(subject, UTF-8)让JavaMail自动做RFC 2047编码正文用setContent(html, text/html;charsetUTF-8)字符集跟在MIME类型后面附件文件名用MimeUtility.encodeText包装后再setFileName接收端用MimeUtility.decodeText还原。三点都命中后跨平台乱码基本消失。值得注意setSubject(String)不指定字符集时按平台默认编码处理Windows下容易出现GBK编码主题这是最常见的中文乱码源头。5.3 项目报告材料组织的顺序这套资源里的文档顺序本身是一条可行时间线开题报告先定技术路线SMTP/POP3选型、JavaMail API方案、Eclipse开发环境任务书把功能拆成发送模块、接收模块、邮件解析模块和界面模块文献综述和项目报告把RFC背景与代码实现对应起来。答辩按协议模型、类结构设计、发送流程、接收流程、测试结果的顺序讲每页PPT配一张类图或交互时序比堆大段代码更有说服力。外文翻译选MIME编码相关章节把编码原理讲通答辩时被追问的概率会低很多。本文还有配套的精品资源点击获取