这篇文章不绕弯子，直接针对SpringMail最常见的报错——从SMTP服务器配置错误、SSL/TLS协议不兼容，到用户名密码加密问题、附件大小限制，把每个问题的“病根”扒清楚，再给你一步到位的解决步骤。不用翻官方文档逐行找，不用猜“是不是版本的锅”，跟着做就能快速摆平问题。
不管你是刚接触的新手，还是偶尔踩坑的老开发，看完这篇都能少走弯路——毕竟解决报错的最快方式，就是精准戳中问题的“七寸”。
你有没有过这种情况？好不容易用SpringMail配好了邮件发送功能，一点“测试发送”就弹红框——要么“连接超时”，要么“认证失败”，更气人的是附件发出去对方收到的是乱码，或者干脆收不到。我去年帮三个做小程序的朋友调过SpringMail，全是这些破问题，后来发现其实没那么复杂，都是“配置细节没踩对”或者“没搞懂邮箱服务商的规矩”。今天就把我踩过的雷、帮朋友解决的经验揉成干货，你跟着做，90%的常见报错都能快速摆平。
最坑的3类SpringMail报错：我帮朋友踩过的雷
先讲最常遇到的三个问题——连接超时、认证失败、附件乱码/发不出去，每个问题我都帮人解决过，背后的原因其实就那几个，搞懂了比记一堆参数有用。
去年帮做生鲜电商的小张调SpringMail，他说“我明明填了smtp.163.com，怎么一直连不上？”我远程一看，好家伙，他把端口写成了25——现在大部分邮箱服务商都禁用25端口了，尤其是阿里云、腾讯云的服务器，默认就封25端口。我让他改成163邮箱的SSL端口465，再测，立马连上了。
为什么会超时？核心原因就两个：SMTP服务器地址/端口错了，或者服务器防火墙拦截了请求。比如你用QQ邮箱，正确的SMTP地址是smtp.qq.com，SSL端口是465，TLS端口是587；要是写成smtp.qq.com:25，肯定连不上。还有一种情况是你的服务器开了防火墙，把 outbound 的465端口挡住了，这时候就算地址对了也连不上。
怎么快速排查？教你个“笨办法”：用telnet命令测端口。比如你要连smtp.qq.com的465端口，打开cmd输入telnet smtp.qq.com 465——要是屏幕变黑，说明端口通；要是提示“无法打开连接”，要么地址错了，要么端口被拦了。
解决步骤也简单：先去你用的邮箱服务商官网查正确的SMTP地址和端口（比如QQ邮箱官网有“POP3/SMTP服务”说明），再核对你Spring配置里的spring.mail.host和spring.mail.port；要是端口对了还连不上，就去服务器后台关了防火墙（或者添加出站规则放行465/587端口）。
第二个坑是“认证失败”——我帮做教育小程序的小李调的时候，他说“我账号密码绝对没错，怎么提示Authentication failed？”我让他打开QQ邮箱设置，一看“POP3/SMTP服务”根本没开，更别说授权码了。现在几乎所有邮箱（QQ、163、 Gmail）都要求用授权码代替登录密码，因为直接用密码太危险，服务商都禁用了。
还有一种情况是你密码输错了——不是登录密码，是授权码。比如QQ邮箱的授权码要自己去“账户”设置里生成，生成的时候要验证手机验证码，生成后要赶紧复制，关掉页面就看不到了。小李之前就是生成了授权码但没保存，后来又重新生成了一次，换上去就好了。
怎么检查？先去邮箱设置里确认POP3/SMTP服务是否开启（比如QQ邮箱在“设置-账户”里找），再确认你用的是授权码而不是登录密码。要是还失败，你可以试试用授权码登录邮箱网页版，要是能登进去，说明授权码没问题；要是登不进去，就是授权码错了，重新生成一个就行。
第三个坑是附件问题——我帮做设计的小王调的时候，他发的PDF附件对方收到是乱码，名字是“???_report.pdf”。我看了他的代码，发现他用MimeMessageHelper的时候没设置编码，默认用了ISO-8859-1，中文文件名肯定乱码。我让他加了一句helper.setAttachment(MimeUtility.encodeText(attachmentName), file)，用UTF-8编码文件名，再发，对方就收到正常的中文名了。
还有一种情况是附件太大——比如网易邮箱默认附件最大50M，要是你发100M的压缩包，肯定发不出去。小王之前发过一个80M的设计图，结果被网易服务器拦截了，后来他把文件拆成两个40M的，就发出去了。
解决附件问题的核心是两点：编码用UTF-8，大小不超过服务商限制。编码方面，不管是附件名还是邮件内容，都尽量用UTF-8；大小方面，你可以去邮箱服务商官网查限制（比如QQ邮箱普通用户附件最大50M，会员1G），要是超过了，要么拆分，要么用“超大附件”功能（比如QQ邮箱的超大附件是存在微云里的，不是直接发附件）。
解决报错的“笨办法”：不用记参数，跟着表格查就行
我知道很多人不想记一堆配置参数，所以整理了个SpringMail常见报错解决表——你遇到问题直接对着查，比翻文档快10倍。表格里的内容都是我帮人解决过的真实案例，每一步都能直接操作。
| 报错类型 | 常见原因 | 快速检查步骤 | 解决办法 |
|---|---|---|---|
| 连接超时 | SMTP地址/端口错误；防火墙拦截；服务器IP被服务商拉黑 |
|
|
| 认证失败 | 账号密码错误；未开启POP3/SMTP服务；授权码过期 |
|
|
| 附件乱码/无法接收 | 附件名编码错误；附件大小超过服务商限制；MIME类型设置错误 |
|
|
| 邮件被归为垃圾邮件 | 发件人邮箱信誉低；邮件内容含敏感词；未设置DKIM/SPF |
|
|
这个表格我自己也常用——比如上次帮朋友解决“邮件被归为垃圾邮件”的问题，我查表格里的“常见原因”，发现他用个人QQ邮箱发促销邮件，内容里有“限时折扣”，结果被网易邮箱归为垃圾邮件。我让他换成企业邮箱，再把内容里的“限时折扣”改成“专属优惠”，再发，就进收件箱了。
对了，还要提醒你一点：不要频繁发测试邮件——比如你半小时发10封测试邮件，邮箱服务商可能会把你的IP拉黑，认为你在发垃圾邮件。我之前帮人调的时候就踩过这个雷，后来等了24小时才解封，所以测试的时候尽量间隔10分钟以上。
最后再给你个“兜底” 先测基础连接，再调代码
要是你按照上面的方法还是解决不了，我 你先脱离Spring，用纯Java Mail测试——比如写个简单的Java类，用Java Mail发送邮件，要是能发出去，说明是Spring配置的问题；要是发不出去，说明是邮箱或服务器的问题。比如下面这个简单的Java Mail测试代码：
import javax.mail.*;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Properties;
public class MailTest {
public static void main(String[] args) {
String from = "你的邮箱@qq.com";
String password = "你的授权码";
String to = "接收邮箱@163.com";
String host = "smtp.qq.com";
Properties props = new Properties();
props.put("mail.smtp.host", host);
props.put("mail.smtp.port", "465");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.ssl.enable", "true");
Session session = Session.getInstance(props, new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(from, password);
}
});
try {
MimeMessage message = new MimeMessage(session);
message.setFrom(new InternetAddress(from));
message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
message.setSubject("测试邮件");
message.setText("这是Java Mail测试邮件");
Transport.send(message);
System.out.println("邮件发送成功！");
} catch (MessagingException e) {
e.printStackTrace();
}
}
}
要是这个代码能发出去，说明你的邮箱和服务器没问题，问题出在Spring的配置上——比如Spring的spring.mail.properties没配置对，比如少了spring.mail.properties.mail.smtp.ssl.enable=true。要是这个代码也发不出去，说明是邮箱或服务器的问题，比如授权码没开，或者端口被拦了。
我之前帮做自媒体的小周调的时候，他的Spring配置没问题，但Java Mail测试也发不出去，后来发现他的服务器IP被QQ邮箱拉黑了——因为他之前用这个IP发过大量垃圾邮件，我让他联系QQ邮箱客服解封，之后就好了。
其实SpringMail的报错真没那么复杂，大部分问题都是“基础配置没搞对”或者“没遵循邮箱服务商的规则”。你只要记住：先测连接，再查认证，最后看内容，跟着表格一步步来，比乱搜教程有用多了。要是你按这些方法试了还有问题，欢迎在评论区留报错信息，我帮你看看——毕竟我踩过的雷，不想让你再踩一遍。
SpringMail连接超时怎么办？是不是服务器的问题？
大概率不是服务器的锅，主要是SMTP地址或端口错了，或者服务器防火墙拦截了请求。比如现在大部分服务商都禁用25端口，你用163邮箱得改成SSL端口465；要是端口对了还连不上，用telnet命令测一下——打开cmd输入“telnet smtp.qq.com 465”，屏幕变黑说明端口通，提示无法连接就是地址错或被拦了。
解决的话，先去邮箱服务商官网查正确的SMTP地址和端口（比如QQ邮箱官网有POP3/SMTP说明），核对Spring配置里的spring.mail.host和spring.mail.port；要是端口对了还不行，去服务器后台关防火墙或者添加出站规则放行465/587端口。
SpringMail提示认证失败，明明密码是对的啊？
别用登录密码！现在几乎所有邮箱（QQ、163、Gmail）都要求用“授权码”代替登录密码——你用登录密码肯定认证失败。比如QQ邮箱得去“设置-账户”里开启POP3/SMTP服务，生成授权码的时候要验证手机验证码，生成后赶紧复制，关掉页面就看不到了。
要是还失败，你可以先用授权码登录邮箱网页版，能登进去说明授权码没问题，登不进去就是码错了，重新生成一个就行；还有种情况是没开POP3/SMTP服务，去邮箱设置里确认一下，开了再试。
SpringMail发的附件名字乱码，对方还收不到？
主要是两个原因：编码错了或者大小超了。附件名有中文的话，得用UTF-8编码，比如用MimeUtility.encodeText(附件名, “UTF-8”, “B”)，不然对方收到的是“???_report.pdf”这种乱码；要是附件大小超过服务商限制，比如网易50M、QQ邮箱普通用户50M，就拆分大附件或者用超大附件功能（比如QQ邮箱的超大附件存在微云里）。
还有MIME类型要设对，比如PDF得设application/pdf，不然对方可能收不到。比如我之前帮做设计的朋友调，他没设置编码，结果附件名乱码，加了MimeUtility.encodeText之后就正常了。
SpringMail报错找不到原因，有没有“兜底”的检查方法？
有个“笨办法”——先脱离Spring，用纯Java Mail写个简单测试类发邮件。比如写个类用Java Mail连接SMTP服务器，发一封测试邮件：要是能发出去，说明是Spring配置的问题（比如少了spring.mail.properties.mail.smtp.ssl.enable=true）；要是发不出去，就是邮箱或服务器的问题（比如授权码没开，或者IP被拉黑）。
我之前帮做自媒体的朋友调过，Spring配置没问题，但Java Mail也发不出去，后来发现他的服务器IP被QQ邮箱拉黑了，联系客服解封之后就好了。这个方法能快速定位问题出在Spring还是外部。
