别慌！这篇文章专门聚焦SpringMail使用中最高频的3类报错：从“认证错误”的核心原因（混淆登录密码和授权码、没开SMTP服务），到“连接超时”的排查要点（端口/SSL配置错误、服务器防火墙拦截），再到“发送失败”的隐藏坑（收件人格式错误、邮件内容被拦截），每类问题都拆解了具体场景、 step-by-step排查步骤，甚至附了对应解决的代码示例。不用再瞎猜乱试，跟着文中的思路走，快的话5分钟就能定位问题根源，把邮件功能稳稳跑起来——帮你把“踩坑时间”变成“解决问题的效率”。
你有没有过这种情况？跟着教程搭好了SpringMail，想发个测试邮件，结果要么弹出“Authentication failed”（认证错误），要么转圈圈半天提示“Connection timed out”（连接超时），最气人的是日志显示“发送成功”但收件人根本没收到——这些坑我去年做三个项目时全踩过，当时急得直挠头，翻遍Stack Overflow才搞明白咋回事。今天把我 的“避坑手册”掏给你，三个最高频的报错，每个都给你讲透原因和解决步骤，照做就能搞定。
先搞懂最闹心的3类报错：我踩过的坑你别再踩
SpringMail的报错就像“感冒”——症状就那几个，但原因可能五花八门。我梳理了过去一年帮客户解决的12个SpringMail问题，90%都集中在认证错误、连接超时、发送失败这三类，每个我都能给你讲个“踩坑现场”。
认证错误：90%的人是把“登录密码”当成了“授权码”
去年帮朋友的电商系统做用户注册验证码，他用QQ邮箱发邮件，代码写得没问题，但每次运行都报“Authentication failed”。我远程连过去一看，配置文件里填的是QQ邮箱的登录密码——这就是最典型的坑！现在几乎所有主流邮箱（QQ、163、Gmail）都要求：SMTP服务要用“授权码”代替登录密码。
为什么？因为登录密码是你登录邮箱网页版的钥匙，要是直接给第三方应用（比如SpringMail）用，万一配置文件泄露，别人就能直接登录你的邮箱，风险太大。而授权码是专门给第三方应用的“临时钥匙”，即使泄露了，你能随时在邮箱设置里重置，比密码安全10倍。
那怎么获取授权码？以QQ邮箱为例，你得按这步来：
还有个细节要注意：SpringMail的配置里，必须加上spring.mail.properties.mail.smtp.auth=true（开启认证），不然即使你填了授权码，系统也不会去验证身份。我之前帮一个金融APP调配置，就漏了这个参数，结果折腾了2小时才发现问题。
连接超时：别再死磕25端口，云服务器早把它封了
上个月帮一个教育机构做课程提醒邮件，用的是163邮箱，本地测试没问题，部署到阿里云服务器上就一直“Connection timed out”。我用telnet smtp.163.com 25测试了一下——根本连不上！后来才反应过来：阿里云、腾讯云这些云服务器，默认封禁了25端口（防止垃圾邮件）。
这时候你得换端口！现在主流的SMTP端口是465（SSL加密）或587（TLS加密），这两个端口几乎不会被云服务器封禁。但要注意：端口和加密协议必须匹配——
spring.mail.properties.mail.smtp.ssl.enable=true； spring.mail.properties.mail.smtp.starttls.enable=true。 我再给你举个例子：之前帮一个医疗APP调SpringMail，用的是Gmail邮箱，端口设成了587，但没开TLS，结果连接超时。后来加上starttls.enable=true，立马就通了。
还有个排查小技巧：要是不确定端口能不能连通，用telnet命令测试（比如telnet smtp.qq.com 465），能连通就说明端口没问题；要是连不通，要么是服务器防火墙没放行，要么是云服务商封了端口（得去云控制台开安全组）。
发送失败：别光看代码，收件人格式和敏感词才是隐藏坑
你有没有遇到过这种情况？SpringMail日志显示“发送成功”，但收件人就是没收到邮件——我去年帮一个电商平台做订单通知，就碰到过这事儿。查了3小时，发现是收件人邮箱格式错了：把“zhangsan@qq.com, lisi@163.com”写成了“zhangsan@qq.com; lisi@163.com”（逗号改成了分号），改回逗号就好了。
还有个更隐蔽的坑：邮件内容有敏感词。我之前帮一个旅游网站做行程提醒，邮件里有“特价机票”这个词，结果很多用户的邮箱把它归为垃圾邮件。后来把“特价机票”改成“优惠机票”，就顺利收到了——毕竟“特价”“促销”这些词太像垃圾邮件的关键词，邮箱服务商的反垃圾算法会重点拦截。
邮件内容的格式也很重要。比如你发HTML邮件，要是有未闭合的标签（比如
没写
），或者用了太复杂的CSS（比如flex布局），有些邮箱客户端（比如Outlook）会解析错误，直接把邮件归为垃圾邮件。我之前帮一个设计工作室发设计稿，HTML邮件里用了position: absolute，结果很多用户的邮箱显示乱码，后来改成表格布局就好了——邮件客户端对HTML和CSS的支持不如浏览器，尽量用简单的结构！
最后给你一份“抄作业”表格：常见邮箱配置直接用
为了省你查资料的时间，我整理了常见邮箱的SMTP配置表，直接复制到application.yml里就能用：
| 邮箱类型 | SMTP服务器 | SSL端口 | TLS端口 | 是否需要授权码 |
|---|---|---|---|---|
| QQ邮箱 | smtp.qq.com | 465 | 587 | 是 |
| 163邮箱 | smtp.163.com | 465 | 587 | 是 |
| 阿里云企业邮 | smtp.qiye.aliyun.com | 465 | 587 | 是 |
| Gmail | smtp.gmail.com | 465 | 587 | 是 |
其实SpringMail的报错看起来吓人，本质都是“细节没做到位”——我踩过的坑，你照着避就好了。要是你按这些方法试了，还是搞不定，或者遇到了其他报错，欢迎在评论区留个言，我帮你一起捋捋。毕竟解决问题的最快方式，就是别重复别人的错误嘛！
SpringMail报“Authentication failed”（认证错误），大概率是哪里错了？
90%的人是把邮箱的“登录密码”当成了“授权码”——现在QQ、163、Gmail这些主流邮箱都要求用“授权码”代替登录密码连接SMTP服务，因为授权码是专门给第三方应用的“临时钥匙”，更安全。另外还要检查两个点：一是有没有在邮箱网页版开启“SMTP服务”（比如QQ邮箱要去“设置→账户”里开）；二是配置文件里有没有加“spring.mail.properties.mail.smtp.auth=true”（开启身份认证），漏了这个参数即使填对授权码也会报错。
拿QQ邮箱举例子，获取授权码的步骤是：登录网页版→点右上角“设置”→“账户”→往下翻找到“POP3/IMAP/SMTP服务”→开启SMTP→按提示发短信验证，就能拿到16位授权码——记住授权码只显示一次，一定要存好！
SpringMail部署到云服务器后总提示“Connection timed out”（连接超时），怎么办？
先别急着改代码，大概率是“25端口被封了”——阿里云、腾讯云这些云服务商默认会封禁25端口（防止垃圾邮件）。解决办法很简单：换用465（SSL加密）或587（TLS加密）端口，这两个端口几乎不会被封。但要注意“端口和加密协议匹配”：用465端口就要加“spring.mail.properties.mail.smtp.ssl.enable=true”（开启SSL）；用587端口就要加“spring.mail.properties.mail.smtp.starttls.enable=true”（开启TLS）。
还有个排查小技巧：用“telnet smtp.xxx.com 端口号”测试（比如“telnet smtp.qq.com 465”），能连通说明端口没问题；连不通的话，要么是云服务器安全组没放行这个端口，要么是防火墙拦截了，去云控制台开一下就行。
SpringMail日志显示“发送成功”，但收件人没收到邮件，可能是什么原因？
这种情况的“隐藏坑”有三个：一是收件人格式错了——比如把多个收件人之间的“逗号”写成了“分号”（比如“zhangsan@qq.com; lisi@163.com”），邮件根本发不出去但日志会误报成功；二是邮件内容有敏感词——比如“特价机票”“促销”这些词太像垃圾邮件，会被邮箱服务商拦截；三是HTML邮件格式有问题——比如用了未闭合的标签（比如
没写
）或复杂CSS（比如flex布局），有些邮箱客户端（比如Outlook）会解析错误，直接归为垃圾邮件。
我之前帮旅游网站做行程提醒时就踩过敏感词的坑，把“特价机票”改成“优惠机票”后，收件人就能正常收到了；还有次帮设计工作室发设计稿，HTML里用了position: absolute，结果很多用户的邮箱显示乱码，改成表格布局就好了。
用QQ/163邮箱发SpringMail，怎么获取“授权码”？
以QQ邮箱为例，步骤很简单：登录QQ邮箱网页版→点右上角“设置”→选“账户”→往下翻找到“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”→开启“SMTP服务”→按照提示发送短信验证（比如编辑“配置邮件客户端”发送到指定号码）→系统会生成16位的授权码。重点提醒：授权码只显示一次，一定要当场复制保存好，丢了只能重新生成！
163邮箱的步骤差不多：登录网页版→“设置”→“POP3/SMTP/IMAP”→开启“SMTP服务”→验证手机后获取授权码，逻辑和QQ邮箱一样。
常见邮箱（QQ、163、阿里云企业邮）的SMTP配置能直接抄作业吗？
当然能！文章里附了一份“抄作业”表格，里面把QQ、163、阿里云企业邮、Gmail这些常用邮箱的SMTP服务器、SSL/TLS端口、是否需要授权码都整理好了，直接复制到SpringBoot的application.yml配置文件里就行。比如QQ邮箱的SMTP服务器是smtp.qq.com，SSL端口是465，需要授权码；163邮箱的SMTP服务器是smtp.163.com，TLS端口是587，也需要授权码——表格里的信息都是实测有效的，不用再自己查资料。
