写邮件这个需求在Java里已经存在十几年了。JavaMailjavax.mail这套API从JDK早期就是标配到现在依然是绝大多数邮件发送功能的核心。不管你是要做一个用户注册验证码、订单通知还是把报表定时发给老板本质上都是同一套流程。这篇文章就用一个完整的、能直接跑通的Java程序把邮件发送这件事拆开讲透。你会在这篇文章里看到SMTP协议到底是什么、如何拿到邮箱授权码、文本邮件怎么发、带附件的邮件怎么发、踩过的坑有哪些端口不通、认证失败、中文乱码、被判定为垃圾邮件以及最实用的排查思路。适合刚学完Java基础、想做点能落地项目的同学也适合工作中第一次接到“发邮件”需求的开发者。1. 邮件发送背后的工作原理与方案选型1.1 SMTP协议与JavaMail的关系邮件发送不是你写个Socket往邮件服务器丢一串字符就完事的。邮件服务器之间、客户端与服务器之间靠的是SMTPSimple Mail Transfer Protocol协议。你从电脑上用Foxmail或Outlook发信本地客户端就是通过SMTP协议把信交给发件服务器发件服务器再通过SMTP协议把信一步步转发到收件人的邮箱服务器。JavaMail并不是重新发明了一套协议它就是把SMTP以及后面会碰到的POP3、IMAP协议封装成了Java类。你要做的就是告诉JavaMail三件事用哪台服务器发信、用什么账号身份发、信的内容是什么。这三件事分别对应JavaMail里的三个核心配置 transports协议配置、Authenticator认证器、MimeMessage邮件对象。所以别把JavaMail想得有多神秘。它的本质就是一套面向对象的SMTP客户端。你在尝试任何“手动Sockct发信”的骚操作之前先理解这点后面的代码就好写了。1.2 为什么用JavaMail而不是其他方案你可能会想现在都微服务了直接用Spring Boot的JavaMailSender不就行了为什么还要学纯JavaMail。我的建议是先学会底层再用框架。Spring的JavaMailSender内部也是封装了JavaMail的它帮你省去了很多配置细节但也会把一些概念埋起来。比如在一次真实项目里Spring配置里明明写了邮箱密码但对方服务器要求必须使用授权码这时你如果不懂JavaMail层面的Authenticator逻辑你会完全摸不着头脑为什么认证失败。另外纯JavaMail没有任何外部依赖一个javax.mail.jar就能跑非常适合做定时任务、命令行工具、小规模的服务端脚本。相比之下为了发一封邮件去引一整个Spring框架明显不划算。1.3 技术选型的核心考量在做技术选型时需要关注的点其实不多是否支持SSL/TLS加密传输现在几乎所有主流邮箱服务商都强制要求是否支持SMTP认证授权码机制各家略有不同是否需要附件、HTML正文、内嵌图片等MIME扩展能力是否方便设置超时、连接池等网络参数。JavaMail全部满足。而且它的API设计这么多年一直很稳定网上能找到海量资料踩坑也容易查。对于“简单的电子邮件发送程序”这个需求JavaMail就是最稳、最直接的答案。2. 开发前的准备工作与关键参数详解2.1 获取SMTP服务器地址与端口发邮件第一步确定你的发件邮箱由哪家服务商提供。每个服务商的SMTP服务器地址和端口都不一样。以常见的服务商为例服务商SMTP服务器SSL端口普通端口是否需授权码某主流免费邮箱Asmtp.a.com46525是某主流免费邮箱Bsmtp.b.com46525是某企业邮箱Csmtp.c.com46525是某主流免费邮箱Dsmtp.d.com46525是端口这块25端口是SMTP的标准端口但现在很多服务商出于反垃圾邮件考虑已经屏蔽了25端口或者强制要求走加密通道。465端口是SMTP over SSL的专用端口587端口是STARTTLS端口。绝大多数情况下我用465端口配合SSL加密最省事。“记住别用25端口大概率连不通。”2.2 邮箱授权码的获取流程这里必须强调一个新手最容易踩的坑JavaMail里填的密码不是你邮箱的登录密码而是授权码。授权码是邮箱服务商为第三方客户端单独生成的一串密码它相当于一把“专用钥匙”只允许用来收发邮件即使泄露了也不会让你整个邮箱账号沦陷。绝大多数服务商都需要你先登录网页版邮箱在设置里找到“客户端授权”或“SMTP服务”选项然后开启服务并生成授权码。拿到授权码后千万别在代码里硬编码明文。项目里临时测试无所谓但一旦代码要提交到仓库建议把授权码放到环境变量或配置中心里去。我见过不少人在GitHub上泄露授权码的第二天邮箱就被拿去滥发广告邮件了。这个教训太常见了。2.3 引入依赖如果你用的是Maven项目在pom.xml里加上dependency groupIdcom.sun.mail/groupId artifactIdjavax.mail/artifactId version1.6.2/version /dependency如果你不想用Maven直接去Maven中央仓库下载javax.mail-1.6.2.jar把它放进项目的classpath里也可以。JavaMail发布包本身就包含了SMTP、IMAP、POP3的实现不需要额外再找别的库。3. 核心代码实现从文本邮件到附件邮件3.1 搭建一个可复用的邮件发送类直接上代码。下面这个类封装了所有参数支持发送普通文本和带附件邮件你可以直接拷贝到项目里使用。import javax.mail.*; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeBodyPart; import javax.mail.internet.MimeMessage; import javax.mail.internet.MimeMultipart; import java.util.Properties; public class SimpleMailSender { private String host; private String port; private String username; private String password; public SimpleMailSender(String host, String port, String username, String password) { this.host host; this.port port; this.username username; this.password password; } private Session createSession() { Properties props new Properties(); // SMTP服务器地址 props.put(mail.smtp.host, host); // 端口号 props.put(mail.smtp.port, port); // 使用SSL加密 props.put(mail.smtp.ssl.enable, true); // 要求认证 props.put(mail.smtp.auth, true); // 设置连接超时时间为10秒 props.put(mail.smtp.connectiontimeout, 10000); // 设置读取超时时间为10秒 props.put(mail.smtp.timeout, 10000); return Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(username, password); } }); } public void sendTextMail(String to, String subject, String content) throws MessagingException { Session session createSession(); MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(username)); message.setRecipient(Message.RecipientType.TO, new InternetAddress(to)); message.setSubject(subject); message.setText(content); Transport.send(message); } public void sendAttachmentMail(String to, String subject, String content, String fileName) throws MessagingException, java.io.IOException { Session session createSession(); MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(username)); message.setRecipient(Message.RecipientType.TO, new InternetAddress(to)); message.setSubject(subject); // 正文部分 MimeBodyPart textPart new MimeBodyPart(); textPart.setText(content); // 附件部分 MimeBodyPart attachmentPart new MimeBodyPart(); attachmentPart.attachFile(fileName); // 将正文和附件组合起来 MimeMultipart multipart new MimeMultipart(); multipart.addBodyPart(textPart); multipart.addBodyPart(attachmentPart); message.setContent(multipart); Transport.send(message); } public static void main(String[] args) throws Exception { SimpleMailSender sender new SimpleMailSender( smtp.example.com, // 替换为你的SMTP服务器 465, // 端口 yourexample.com, // 发件人邮箱 your-auth-code // 授权码 ); sender.sendTextMail( receiverexample.com, 测试邮件, 你好这是一封来自JavaMail的测试邮件。 ); System.out.println(邮件发送成功); } }注意这段代码里的几个细节message.setFrom()这里用了发件人邮箱地址但某些服务商要求发件人地址必须与认证账号一致否则会报错。如果你要设置发件人显示名称比如“XX系统通知”可以用message.setFrom(new InternetAddress(username, XX系统通知));3.2 理解邮件消息的结构MIME 与 Multipart如果你只发纯文本上面代码里message.setText(content)就够了。但一旦涉及附件或HTML正文就必须理解MIME。MIME的全称是Multipurpose Internet Mail Extensions它定义了邮件正文、附件、内嵌图片等如何在这个文本协议里表达。一封带附件的邮件在JavaMail里是由MimeMultipart对象包起来的外层是一个Multipart里面分别放入正文的MimeBodyPart和附件的MimeBodyPart。如果把邮件比作一个快递包裹MimeMultipart就是那个外包装箱MimeBodyPart就是箱子里的各个物品。你往箱子里放一件衣服正文和一个U盘附件收件人打开箱子会看到衣服和U盘是分开的。JavaMail里就是通过addBodyPart()把各个部分装进去再用message.setContent(multipart)把整个箱子装进信封里。这个道理理解了你以后想加第二个附件、第三张内嵌图片就只需要多创建几个MimeBodyPart然后addBodyPart()进去就行。3.3 发送HTML富文本邮件很多业务场景下纯文本邮件不够用。比如注册激活邮件要放一个链接按钮营销邮件要放图片和样式。这时候需要发送HTML格式的邮件。MimeBodyPart htmlPart new MimeBodyPart(); htmlPart.setContent(h2激活你的账号/h2a hrefhttps://example.com/activate?token123456点击激活/a, text/html;charsetutf-8); MimeMultipart multipart new MimeMultipart(); multipart.addBodyPart(htmlPart); message.setContent(multipart);关键点是setContent()的第二个参数必须写成text/html;charsetutf-8否则收件人看到的会是HTML源码而不是渲染后的页面。顺便说一句HTML邮件里的样式支持远不如网页很多邮箱客户端会过滤style标签或class属性所以做邮件模板时尽量用内联样式。3.4 发送带附件的邮件时的中文文件名处理附件名是中文的时候会出现一个经典问题收件人收到的附件名是一堆乱码。这背后的原因是SMTP协议传输层只支持ASCII字符中文文件名必须经过编码。JavaMail在英文环境下默认采用text/plain的编码方式不能正确处理非ASCII字符。解决办法是手动指定编码attachmentPart.setFileName(MimeUtility.encodeText(季度报表.xlsx, UTF-8, B));MimeUtility.encodeText()方法会将中文文件名编码成类似?UTF-8?B?5bmz5a2m...?的格式收件人客户端会自动解码回“季度报表.xlsx”。这一步不加你发出去的邮件附件名大概率就是一堆问号。3.5 群发与抄送、密送的实现JavaMail支持三种收件人类型// 普通收件人 message.setRecipient(Message.RecipientType.TO, new InternetAddress(aexample.com)); // 抄送 message.setRecipient(Message.RecipientType.CC, new InternetAddress(bexample.com)); // 密送 message.setRecipient(Message.RecipientType.BCC, new InternetAddress(cexample.com));群发给多个普通收件人可以用setRecipients()传入一个地址数组message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(aexample.com,bexample.com,cexample.com));这里有个容易忽略的细节地址之间用英文逗号分隔不能用中文逗号否则InternetAddress.parse()会抛出异常。而且setRecipients()不是追加是覆盖如果你先setRecipient()一次再setRecipients()一次后面的会覆盖前面的很多人在这里栽过跟头。4. 常见问题与排查思路实录4.1 连接超时端口不通的快速定位症状程序卡在Transport.connect()这一步几十秒后报SocketTimeoutException。原因及解决方案我这里整理了速查表现象可能原因解决方式465端口超时服务器不支持SSL或本地网络屏蔽了465尝试587端口STARTTLS模式25端口超时运营商封锁了25端口用于反垃圾邮件改用465或587端口偶尔超时、偶尔成功客户端与邮件服务器之间的网络抖动调大超时时间或者加入重试机制本地通、服务器上不通服务器防火墙限制了出站端口检查防火墙策略开放对应出站端口注意如果你在公司内网环境很大概率是防火墙只放行了部分端口。建议先在本地用命令行工具测试SMTP端口连通性再查代码问题。4.2 认证失败八成是授权码问题报错长这样AuthenticationFailedException: 535 Error: authentication failed。看到535意味着用户名密码不对但有几种情况很容易误导人第一种账号填错了。有人用了不带域名后缀的用户名比如只填了zhangsan而不是zhangsanexample.com。第二种把登录密码当授权码用了。服务商明确要求第三方客户端必须用授权码但你填的是网页登录密码认证必然失败。第三种授权码本身过期或重新生成过。某些服务商在检测到异地登录或安全风险时会自动失效旧授权码需要重新生成。处理方法第一检查用户名是否完整第二重置授权码重新配置第三开启JavaMail的会话调试模式。怎么开启调试模式在Session创建之前加一行props.put(mail.debug, true);这样会在控制台打印出完整的SMTP交互日志包括服务器返回的详细错误信息排查问题非常有效。我第一次调试认证失败就是靠这行配置看到了服务器返回的“auth code has been expired”信息才定位到是授权码过期。4.3 中文乱码邮件头与正文的编码处理中文乱码分为两种情况。正文乱码常见于message.setText(content)后收件人看到的是乱码。解决方式是明确指定字符集message.setText(content, UTF-8);或者在使用setContent()时带上参数message.setContent(content, text/plain;charsetUTF-8);标题乱码邮件主题中出现?UTF-8?...?这种字符串是主题没有被客户端正确解码。正确做法message.setSubject(subject, UTF-8);这两个API都提供了重载版本第二个参数指定字符集。JavaMail内部会帮你完成RFC 2047编码收件人端就能正常显示。4.4 发送成功但收件人没收到这是最玄学的问题。代码没报错邮件发送成功但对方就是收不到。排查顺序一般是第一看垃圾邮件箱。新域名、新账号、纯文本低交互内容的邮件很容易被邮箱服务商判为垃圾邮件。第二看是否有退信。如果收件人地址错误或对方服务器拒收发件服务器一般会返回一封退信邮件退信里的Failure和554等关键字能说明问题。第三发件人信誉问题。频繁发送营销内容或者发件人域名没有配置SPF和DKIM记录邮件会被收件方门槛拦下来。JavaMail本身不负责SPF、DKIM但这些机制会在邮件到达对方服务器时影响判定。提示如果你在开发环境反复发送测试邮件建议使用真实邮箱互发不要用自己给自己发这样很容易被服务商识别为异常行为。4.5 附件过大或文件名特殊字符异常附件超过服务商限制如某免费邮箱限制单封邮件不超过50MB会在发送时报错。特殊字符方面文件名里带;、,、换行符这些字符会让MimeBodyPart.attachFile()抛异常或者导致收件人端显示异常。处理方式是使用原生的setFileName()配合MimeUtility.encodeText()编码并且不要手动拼接文件名。5. 进阶扩展日志、重试与生产环境配置5.1 引入日志替代System.out上面Demo里用了System.out.println实际生产项目中建议换成SLF4J之类的日志框架。邮件发送是IO操作可能失败也可能慢日志里记录下收件人、主题、发送结果、耗时对后续排查很有帮助。日志示例logger.info(准备发送邮件收件人{}主题{}, to, subject); try { Transport.send(message); logger.info(邮件发送成功收件人{}耗时{}ms, to, costTime); } catch (MessagingException e) { logger.error(邮件发送失败收件人{}原因{}, to, e.getMessage(), e); throw e; }无论如何不要打印授权码不要打印完整邮件正文。日志会进ELK之类的系统授权码这种敏感信息一旦打印出来就相当于对能看到日志的每一个人敞开邮箱大门。5.2 加入重试机制邮件服务器偶尔会抽风。一次发不出去重试一次也许就好了。但重试不是无脑重发否则可能造成对方收到重复邮件。我的方案是基于异常的确定性判断来决定是否重试。AuthenticationFailedException不重试因为重试也没用授权码错误不会因为重试变正确。MessagingException中的网络层异常值得重试比如SocketTimeoutException。一个简单的重试模板int maxRetryTimes 3; for (int i 1; i maxRetryTimes; i) { try { Transport.send(message); break; } catch (MessagingException e) { if (i maxRetryTimes) { throw e; } Thread.sleep(2000L * i); // 退避 logger.warn(第{}次发送失败准备重试, i); } }重试间隔采用指数退避的方式第一次重试等2秒第二次等4秒避免在服务器已经过载的情况下继续施压。5.3 连接复用与线程安全JavaMail的Session对象是线程安全的你可以复用。但Transport对象不是每次发送最好都通过Transport.send(message)这个静态方法来建立连接并释放不要在并发场景下手动共享一个Transport。高并发场景下更推荐使用连接池方案或者干脆用Spring Boot的JavaMailSender它内部对连接做了池化处理。日常简单场景每次发送新建连接的开销完全可接受不需要过度设计。实测下来单次发送耗时一般在几百毫秒到两三秒之间瓶颈多在网络和服务器响应上。5.4 邮件模板的管理业务里邮件内容往往是固定的模板不要每次在代码里拼字符串。建议把模板放到独立的文件里占位符用${xxx}这种形式然后程序里做替换。String template p尊敬的${name}/pp您的验证码是b${code}/b/p; String content template .replace(${name}, 张三) .replace(${code}, 123456);这样做的好处是运营同学可以直接改模板不需要动代码。如果项目已经用了Spring还可以把模板放在resources目录下使用Thymeleaf或FreeMarker渲染但就“简单邮件程序”而言字符串替换完全够用。6. 几个容易忽略的小细节与最终建议6.1 SSL证书验证问题自建内网邮件服务器往往使用自签名证书Java的SslContext默认信任链里没有它连接就会报证书不信任的错误。解决办法不是粗暴地关闭SSL验证而是把自签名证书导入本机的密钥库。实际操作中很多内部系统图省事会配置mail.smtp.ssl.trust为*来跳过校验但这不是长久之计特别是涉及财务、人事等敏感邮件时。我建议导入证书一劳永逸安全合规。6.2 抄送给自己的调试习惯想快速验证代码可以把发件人、收件人都填成自己的邮箱。这样避免了骚扰别人也方便随时查收。我在写测试用例的时候经常给自己发一封带HTML和附件的邮件确认格式渲染正常。6.3 发送附件时文件的临时目录清理如果附件来自服务器临时目录记得发送完毕后删除临时文件否则会堆满运行机器的磁盘。我看到过不止一次线上事故就是因为发送邮件后忘记清理临时文件最后磁盘告警服务挂掉。而一个“简单邮件程序”之所以能持续稳定运行往往就是这些不起眼的细节撑住的。写到这里关于Java发送电子邮件的主要知识已经覆盖了。我个人实际操作中的体会是JavaMail这套东西原理不复杂但它把很多协议细节隐藏了起来导致出错时新手很难定位。最好的学习方式是自己动手写一个发文本邮件的Demo跑通了再加附件再加HTML邮件一步一脚印地把每个环节都实现一遍。只要把上面的授权码、端口、编码这三个核心点搞明白多数的坑你都能轻松绕过去。
写邮件这个需求在Java里已经存在十几年了。JavaMailjavax.mail这套API从JDK早期就是标配到现在依然是绝大多数邮件发送功能的核心。不管你是要做一个用户注册验证码、订单通知还是把报表定时发给老板本质上都是同一套流程。这篇文章就用一个完整的、能直接跑通的Java程序把邮件发送这件事拆开讲透。你会在这篇文章里看到SMTP协议到底是什么、如何拿到邮箱授权码、文本邮件怎么发、带附件的邮件怎么发、踩过的坑有哪些端口不通、认证失败、中文乱码、被判定为垃圾邮件以及最实用的排查思路。适合刚学完Java基础、想做点能落地项目的同学也适合工作中第一次接到“发邮件”需求的开发者。1. 邮件发送背后的工作原理与方案选型1.1 SMTP协议与JavaMail的关系邮件发送不是你写个Socket往邮件服务器丢一串字符就完事的。邮件服务器之间、客户端与服务器之间靠的是SMTPSimple Mail Transfer Protocol协议。你从电脑上用Foxmail或Outlook发信本地客户端就是通过SMTP协议把信交给发件服务器发件服务器再通过SMTP协议把信一步步转发到收件人的邮箱服务器。JavaMail并不是重新发明了一套协议它就是把SMTP以及后面会碰到的POP3、IMAP协议封装成了Java类。你要做的就是告诉JavaMail三件事用哪台服务器发信、用什么账号身份发、信的内容是什么。这三件事分别对应JavaMail里的三个核心配置 transports协议配置、Authenticator认证器、MimeMessage邮件对象。所以别把JavaMail想得有多神秘。它的本质就是一套面向对象的SMTP客户端。你在尝试任何“手动Sockct发信”的骚操作之前先理解这点后面的代码就好写了。1.2 为什么用JavaMail而不是其他方案你可能会想现在都微服务了直接用Spring Boot的JavaMailSender不就行了为什么还要学纯JavaMail。我的建议是先学会底层再用框架。Spring的JavaMailSender内部也是封装了JavaMail的它帮你省去了很多配置细节但也会把一些概念埋起来。比如在一次真实项目里Spring配置里明明写了邮箱密码但对方服务器要求必须使用授权码这时你如果不懂JavaMail层面的Authenticator逻辑你会完全摸不着头脑为什么认证失败。另外纯JavaMail没有任何外部依赖一个javax.mail.jar就能跑非常适合做定时任务、命令行工具、小规模的服务端脚本。相比之下为了发一封邮件去引一整个Spring框架明显不划算。1.3 技术选型的核心考量在做技术选型时需要关注的点其实不多是否支持SSL/TLS加密传输现在几乎所有主流邮箱服务商都强制要求是否支持SMTP认证授权码机制各家略有不同是否需要附件、HTML正文、内嵌图片等MIME扩展能力是否方便设置超时、连接池等网络参数。JavaMail全部满足。而且它的API设计这么多年一直很稳定网上能找到海量资料踩坑也容易查。对于“简单的电子邮件发送程序”这个需求JavaMail就是最稳、最直接的答案。2. 开发前的准备工作与关键参数详解2.1 获取SMTP服务器地址与端口发邮件第一步确定你的发件邮箱由哪家服务商提供。每个服务商的SMTP服务器地址和端口都不一样。以常见的服务商为例服务商SMTP服务器SSL端口普通端口是否需授权码某主流免费邮箱Asmtp.a.com46525是某主流免费邮箱Bsmtp.b.com46525是某企业邮箱Csmtp.c.com46525是某主流免费邮箱Dsmtp.d.com46525是端口这块25端口是SMTP的标准端口但现在很多服务商出于反垃圾邮件考虑已经屏蔽了25端口或者强制要求走加密通道。465端口是SMTP over SSL的专用端口587端口是STARTTLS端口。绝大多数情况下我用465端口配合SSL加密最省事。“记住别用25端口大概率连不通。”2.2 邮箱授权码的获取流程这里必须强调一个新手最容易踩的坑JavaMail里填的密码不是你邮箱的登录密码而是授权码。授权码是邮箱服务商为第三方客户端单独生成的一串密码它相当于一把“专用钥匙”只允许用来收发邮件即使泄露了也不会让你整个邮箱账号沦陷。绝大多数服务商都需要你先登录网页版邮箱在设置里找到“客户端授权”或“SMTP服务”选项然后开启服务并生成授权码。拿到授权码后千万别在代码里硬编码明文。项目里临时测试无所谓但一旦代码要提交到仓库建议把授权码放到环境变量或配置中心里去。我见过不少人在GitHub上泄露授权码的第二天邮箱就被拿去滥发广告邮件了。这个教训太常见了。2.3 引入依赖如果你用的是Maven项目在pom.xml里加上dependency groupIdcom.sun.mail/groupId artifactIdjavax.mail/artifactId version1.6.2/version /dependency如果你不想用Maven直接去Maven中央仓库下载javax.mail-1.6.2.jar把它放进项目的classpath里也可以。JavaMail发布包本身就包含了SMTP、IMAP、POP3的实现不需要额外再找别的库。3. 核心代码实现从文本邮件到附件邮件3.1 搭建一个可复用的邮件发送类直接上代码。下面这个类封装了所有参数支持发送普通文本和带附件邮件你可以直接拷贝到项目里使用。import javax.mail.*; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeBodyPart; import javax.mail.internet.MimeMessage; import javax.mail.internet.MimeMultipart; import java.util.Properties; public class SimpleMailSender { private String host; private String port; private String username; private String password; public SimpleMailSender(String host, String port, String username, String password) { this.host host; this.port port; this.username username; this.password password; } private Session createSession() { Properties props new Properties(); // SMTP服务器地址 props.put(mail.smtp.host, host); // 端口号 props.put(mail.smtp.port, port); // 使用SSL加密 props.put(mail.smtp.ssl.enable, true); // 要求认证 props.put(mail.smtp.auth, true); // 设置连接超时时间为10秒 props.put(mail.smtp.connectiontimeout, 10000); // 设置读取超时时间为10秒 props.put(mail.smtp.timeout, 10000); return Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(username, password); } }); } public void sendTextMail(String to, String subject, String content) throws MessagingException { Session session createSession(); MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(username)); message.setRecipient(Message.RecipientType.TO, new InternetAddress(to)); message.setSubject(subject); message.setText(content); Transport.send(message); } public void sendAttachmentMail(String to, String subject, String content, String fileName) throws MessagingException, java.io.IOException { Session session createSession(); MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(username)); message.setRecipient(Message.RecipientType.TO, new InternetAddress(to)); message.setSubject(subject); // 正文部分 MimeBodyPart textPart new MimeBodyPart(); textPart.setText(content); // 附件部分 MimeBodyPart attachmentPart new MimeBodyPart(); attachmentPart.attachFile(fileName); // 将正文和附件组合起来 MimeMultipart multipart new MimeMultipart(); multipart.addBodyPart(textPart); multipart.addBodyPart(attachmentPart); message.setContent(multipart); Transport.send(message); } public static void main(String[] args) throws Exception { SimpleMailSender sender new SimpleMailSender( smtp.example.com, // 替换为你的SMTP服务器 465, // 端口 yourexample.com, // 发件人邮箱 your-auth-code // 授权码 ); sender.sendTextMail( receiverexample.com, 测试邮件, 你好这是一封来自JavaMail的测试邮件。 ); System.out.println(邮件发送成功); } }注意这段代码里的几个细节message.setFrom()这里用了发件人邮箱地址但某些服务商要求发件人地址必须与认证账号一致否则会报错。如果你要设置发件人显示名称比如“XX系统通知”可以用message.setFrom(new InternetAddress(username, XX系统通知));3.2 理解邮件消息的结构MIME 与 Multipart如果你只发纯文本上面代码里message.setText(content)就够了。但一旦涉及附件或HTML正文就必须理解MIME。MIME的全称是Multipurpose Internet Mail Extensions它定义了邮件正文、附件、内嵌图片等如何在这个文本协议里表达。一封带附件的邮件在JavaMail里是由MimeMultipart对象包起来的外层是一个Multipart里面分别放入正文的MimeBodyPart和附件的MimeBodyPart。如果把邮件比作一个快递包裹MimeMultipart就是那个外包装箱MimeBodyPart就是箱子里的各个物品。你往箱子里放一件衣服正文和一个U盘附件收件人打开箱子会看到衣服和U盘是分开的。JavaMail里就是通过addBodyPart()把各个部分装进去再用message.setContent(multipart)把整个箱子装进信封里。这个道理理解了你以后想加第二个附件、第三张内嵌图片就只需要多创建几个MimeBodyPart然后addBodyPart()进去就行。3.3 发送HTML富文本邮件很多业务场景下纯文本邮件不够用。比如注册激活邮件要放一个链接按钮营销邮件要放图片和样式。这时候需要发送HTML格式的邮件。MimeBodyPart htmlPart new MimeBodyPart(); htmlPart.setContent(h2激活你的账号/h2a hrefhttps://example.com/activate?token123456点击激活/a, text/html;charsetutf-8); MimeMultipart multipart new MimeMultipart(); multipart.addBodyPart(htmlPart); message.setContent(multipart);关键点是setContent()的第二个参数必须写成text/html;charsetutf-8否则收件人看到的会是HTML源码而不是渲染后的页面。顺便说一句HTML邮件里的样式支持远不如网页很多邮箱客户端会过滤style标签或class属性所以做邮件模板时尽量用内联样式。3.4 发送带附件的邮件时的中文文件名处理附件名是中文的时候会出现一个经典问题收件人收到的附件名是一堆乱码。这背后的原因是SMTP协议传输层只支持ASCII字符中文文件名必须经过编码。JavaMail在英文环境下默认采用text/plain的编码方式不能正确处理非ASCII字符。解决办法是手动指定编码attachmentPart.setFileName(MimeUtility.encodeText(季度报表.xlsx, UTF-8, B));MimeUtility.encodeText()方法会将中文文件名编码成类似?UTF-8?B?5bmz5a2m...?的格式收件人客户端会自动解码回“季度报表.xlsx”。这一步不加你发出去的邮件附件名大概率就是一堆问号。3.5 群发与抄送、密送的实现JavaMail支持三种收件人类型// 普通收件人 message.setRecipient(Message.RecipientType.TO, new InternetAddress(aexample.com)); // 抄送 message.setRecipient(Message.RecipientType.CC, new InternetAddress(bexample.com)); // 密送 message.setRecipient(Message.RecipientType.BCC, new InternetAddress(cexample.com));群发给多个普通收件人可以用setRecipients()传入一个地址数组message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(aexample.com,bexample.com,cexample.com));这里有个容易忽略的细节地址之间用英文逗号分隔不能用中文逗号否则InternetAddress.parse()会抛出异常。而且setRecipients()不是追加是覆盖如果你先setRecipient()一次再setRecipients()一次后面的会覆盖前面的很多人在这里栽过跟头。4. 常见问题与排查思路实录4.1 连接超时端口不通的快速定位症状程序卡在Transport.connect()这一步几十秒后报SocketTimeoutException。原因及解决方案我这里整理了速查表现象可能原因解决方式465端口超时服务器不支持SSL或本地网络屏蔽了465尝试587端口STARTTLS模式25端口超时运营商封锁了25端口用于反垃圾邮件改用465或587端口偶尔超时、偶尔成功客户端与邮件服务器之间的网络抖动调大超时时间或者加入重试机制本地通、服务器上不通服务器防火墙限制了出站端口检查防火墙策略开放对应出站端口注意如果你在公司内网环境很大概率是防火墙只放行了部分端口。建议先在本地用命令行工具测试SMTP端口连通性再查代码问题。4.2 认证失败八成是授权码问题报错长这样AuthenticationFailedException: 535 Error: authentication failed。看到535意味着用户名密码不对但有几种情况很容易误导人第一种账号填错了。有人用了不带域名后缀的用户名比如只填了zhangsan而不是zhangsanexample.com。第二种把登录密码当授权码用了。服务商明确要求第三方客户端必须用授权码但你填的是网页登录密码认证必然失败。第三种授权码本身过期或重新生成过。某些服务商在检测到异地登录或安全风险时会自动失效旧授权码需要重新生成。处理方法第一检查用户名是否完整第二重置授权码重新配置第三开启JavaMail的会话调试模式。怎么开启调试模式在Session创建之前加一行props.put(mail.debug, true);这样会在控制台打印出完整的SMTP交互日志包括服务器返回的详细错误信息排查问题非常有效。我第一次调试认证失败就是靠这行配置看到了服务器返回的“auth code has been expired”信息才定位到是授权码过期。4.3 中文乱码邮件头与正文的编码处理中文乱码分为两种情况。正文乱码常见于message.setText(content)后收件人看到的是乱码。解决方式是明确指定字符集message.setText(content, UTF-8);或者在使用setContent()时带上参数message.setContent(content, text/plain;charsetUTF-8);标题乱码邮件主题中出现?UTF-8?...?这种字符串是主题没有被客户端正确解码。正确做法message.setSubject(subject, UTF-8);这两个API都提供了重载版本第二个参数指定字符集。JavaMail内部会帮你完成RFC 2047编码收件人端就能正常显示。4.4 发送成功但收件人没收到这是最玄学的问题。代码没报错邮件发送成功但对方就是收不到。排查顺序一般是第一看垃圾邮件箱。新域名、新账号、纯文本低交互内容的邮件很容易被邮箱服务商判为垃圾邮件。第二看是否有退信。如果收件人地址错误或对方服务器拒收发件服务器一般会返回一封退信邮件退信里的Failure和554等关键字能说明问题。第三发件人信誉问题。频繁发送营销内容或者发件人域名没有配置SPF和DKIM记录邮件会被收件方门槛拦下来。JavaMail本身不负责SPF、DKIM但这些机制会在邮件到达对方服务器时影响判定。提示如果你在开发环境反复发送测试邮件建议使用真实邮箱互发不要用自己给自己发这样很容易被服务商识别为异常行为。4.5 附件过大或文件名特殊字符异常附件超过服务商限制如某免费邮箱限制单封邮件不超过50MB会在发送时报错。特殊字符方面文件名里带;、,、换行符这些字符会让MimeBodyPart.attachFile()抛异常或者导致收件人端显示异常。处理方式是使用原生的setFileName()配合MimeUtility.encodeText()编码并且不要手动拼接文件名。5. 进阶扩展日志、重试与生产环境配置5.1 引入日志替代System.out上面Demo里用了System.out.println实际生产项目中建议换成SLF4J之类的日志框架。邮件发送是IO操作可能失败也可能慢日志里记录下收件人、主题、发送结果、耗时对后续排查很有帮助。日志示例logger.info(准备发送邮件收件人{}主题{}, to, subject); try { Transport.send(message); logger.info(邮件发送成功收件人{}耗时{}ms, to, costTime); } catch (MessagingException e) { logger.error(邮件发送失败收件人{}原因{}, to, e.getMessage(), e); throw e; }无论如何不要打印授权码不要打印完整邮件正文。日志会进ELK之类的系统授权码这种敏感信息一旦打印出来就相当于对能看到日志的每一个人敞开邮箱大门。5.2 加入重试机制邮件服务器偶尔会抽风。一次发不出去重试一次也许就好了。但重试不是无脑重发否则可能造成对方收到重复邮件。我的方案是基于异常的确定性判断来决定是否重试。AuthenticationFailedException不重试因为重试也没用授权码错误不会因为重试变正确。MessagingException中的网络层异常值得重试比如SocketTimeoutException。一个简单的重试模板int maxRetryTimes 3; for (int i 1; i maxRetryTimes; i) { try { Transport.send(message); break; } catch (MessagingException e) { if (i maxRetryTimes) { throw e; } Thread.sleep(2000L * i); // 退避 logger.warn(第{}次发送失败准备重试, i); } }重试间隔采用指数退避的方式第一次重试等2秒第二次等4秒避免在服务器已经过载的情况下继续施压。5.3 连接复用与线程安全JavaMail的Session对象是线程安全的你可以复用。但Transport对象不是每次发送最好都通过Transport.send(message)这个静态方法来建立连接并释放不要在并发场景下手动共享一个Transport。高并发场景下更推荐使用连接池方案或者干脆用Spring Boot的JavaMailSender它内部对连接做了池化处理。日常简单场景每次发送新建连接的开销完全可接受不需要过度设计。实测下来单次发送耗时一般在几百毫秒到两三秒之间瓶颈多在网络和服务器响应上。5.4 邮件模板的管理业务里邮件内容往往是固定的模板不要每次在代码里拼字符串。建议把模板放到独立的文件里占位符用${xxx}这种形式然后程序里做替换。String template p尊敬的${name}/pp您的验证码是b${code}/b/p; String content template .replace(${name}, 张三) .replace(${code}, 123456);这样做的好处是运营同学可以直接改模板不需要动代码。如果项目已经用了Spring还可以把模板放在resources目录下使用Thymeleaf或FreeMarker渲染但就“简单邮件程序”而言字符串替换完全够用。6. 几个容易忽略的小细节与最终建议6.1 SSL证书验证问题自建内网邮件服务器往往使用自签名证书Java的SslContext默认信任链里没有它连接就会报证书不信任的错误。解决办法不是粗暴地关闭SSL验证而是把自签名证书导入本机的密钥库。实际操作中很多内部系统图省事会配置mail.smtp.ssl.trust为*来跳过校验但这不是长久之计特别是涉及财务、人事等敏感邮件时。我建议导入证书一劳永逸安全合规。6.2 抄送给自己的调试习惯想快速验证代码可以把发件人、收件人都填成自己的邮箱。这样避免了骚扰别人也方便随时查收。我在写测试用例的时候经常给自己发一封带HTML和附件的邮件确认格式渲染正常。6.3 发送附件时文件的临时目录清理如果附件来自服务器临时目录记得发送完毕后删除临时文件否则会堆满运行机器的磁盘。我看到过不止一次线上事故就是因为发送邮件后忘记清理临时文件最后磁盘告警服务挂掉。而一个“简单邮件程序”之所以能持续稳定运行往往就是这些不起眼的细节撑住的。写到这里关于Java发送电子邮件的主要知识已经覆盖了。我个人实际操作中的体会是JavaMail这套东西原理不复杂但它把很多协议细节隐藏了起来导致出错时新手很难定位。最好的学习方式是自己动手写一个发文本邮件的Demo跑通了再加附件再加HTML邮件一步一脚印地把每个环节都实现一遍。只要把上面的授权码、端口、编码这三个核心点搞明白多数的坑你都能轻松绕过去。
