JavaMail配置详解：邮件发送教程指南

本文深入剖析了JavaMail API邮件发送的核心配置要点与常见陷阱，从SMTP服务器匹配、认证方式（App Password/OAuth2替代密码）、TLS/SSL协议选择，到AuthenticationFailedException的精准排查方法，再到MimeMessage中收件人设置、中文主题编码、HTML正文处理等易错细节，最后延伸至Spring Boot中JavaMailSender的正确配置实践，强调“没有通用配置，唯有按服务商文档逐项验证”，为开发者提供一套即学即用、避坑高效的Java邮件发送实战指南。

JavaMail API 发送邮件前必须确认的三件事

不配对 SMTP 服务器和认证方式，代码跑得再顺也发不出去。JavaMail 不是“写完就能发”，它本质是把你的邮件内容打包成标准协议数据，扔给 SMTP 服务器——而这个服务器是否接受你、是否要登录、走不走 TLS，全由你填的配置决定。

• host 和 port 必须匹配：比如用 smtp.gmail.com 就不能配 25 端口（默认被禁），得选 587（STARTTLS）或 465（SSL）
• 大多数现代邮箱（Gmail、Outlook、QQ 邮箱）已禁用“密码登录”，必须用 App Password 或 OAuth2，直接填邮箱密码会报 AuthenticationFailedException
• Java 17+ 默认禁用旧版 SSL/TLS 协议，如果还硬配 mail.smtp.ssl.enable=true + 465，可能在某些环境静默失败——优先用 mail.smtp.starttls.enable=true + 587

send() 报 javax.mail.AuthenticationFailedException 怎么快速定位

这个异常不是 JavaMail 的 bug，而是 SMTP 服务器明确拒绝了你的凭据或连接方式。别急着改代码，先查这三点：

• 确认账号已开启“SMTP 服务”：Gmail 要进 Google 账户安全设置 开“两步验证”，再生成 App Password；QQ 邮箱要进“设置 → 账户 → POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”开启 SMTP 并记下授权码
• 检查 Session 创建时是否传入了正确的 Authenticator 实例，且 getPasswordAuthentication() 返回的 username 是完整邮箱（如 user@gmail.com），不是昵称或用户名
• 抓包或加日志：在 Properties 中设 mail.debug=true，运行时看控制台输出的真实 SMTP 对话，重点找 535-5.7.8 或 534-5.7.9 这类错误码，它们比 Java 异常更准

用 MimeMessage 设置收件人、主题、HTML 正文的常见错法

看似简单的 setXXX 方法，参数类型和编码稍不注意就会导致乱码或收件人解析失败。

• setRecipients() 接收的是 Message.RecipientType 枚举 + Address[]，别直接传字符串数组；正确写法：message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("a@b.com,c@d.com"))
• 中文主题必须用 MimeUtility.encodeText() 包一层，否则 Outlook 可能显示问号：message.setSubject(MimeUtility.encodeText("订单通知", "UTF-8", "B"))
• 发 HTML 邮件必须设 setContent() 的 MIME 类型为 "text/html; charset=UTF-8"，只设 setText() 会当纯文本处理， 标签原样显示

JavaMail 在 Spring Boot 里怎么避免手动 new Session