Java邮件通知服务核心是用Jakarta Mail API配合SMTP协议,需正确配置服务器参数、认证方式及邮件内容,并注意授权码使用、中文编码、附件处理与生产环境的可配置性、重试、日志和安全管控。

Java中实现邮件通知服务,核心是使用JavaMail API配合SMTP协议发送邮件。关键在于配置正确的邮件服务器参数、处理认证、构造邮件内容,并做好异常和连接管理。
SMTP服务器配置要点
不同邮箱服务商的SMTP地址和端口不同,需按实际选择:
- QQ邮箱:smtp.qq.com,端口587(TLS)或465(SSL)
- 163邮箱:smtp.163.com,端口465(SSL)或994(SMTPS)
- Gmail:smtp.gmail.com,端口587(需开启两步验证并生成应用专用密码)
注意:现代邮箱普遍禁用明文密码登录,必须使用授权码或应用专用密码,而非账户登录密码。
JavaMail依赖与基础发送代码
使用Maven引入JavaMail(Jakarta Mail,新版已迁移到jakarta.mail):
立即学习“Java免费学习笔记(深入)”;
jakarta.mail jakarta.mail-api 2.1.3 com.sun.mail jakarta.mail 2.0.1
发送纯文本邮件示例:
Properties props = new Properties();
props.put("mail.smtp.host", "smtp.qq.com");
props.put("mail.smtp.port", "587");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");
Session session = Session.getInstance(props, new Authenticator() {
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication("your_email@qq.com", "your_app_password");
}
});
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress("your_email@qq.com"));
message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("to@example.com"));
message.setSubject("测试邮件");
message.setText("这是一封Java发送的SMTP邮件。");
Transport.send(message);
支持HTML内容与附件的增强写法
发送富文本或带附件的邮件,需构建MimeMultipart:
常见问题:中文乱码需统一设置setHeader("Content-Transfer-Encoding", "base64")并指定字符集为UTF-8;大附件注意超时和内存占用,建议异步发送+流式上传。
生产环境注意事项
真实项目中不能裸写发送逻辑,需封装成可配置、可监控的服务:
- 将SMTP配置抽离到
application.yml或配置中心 - 添加重试机制(如Spring Retry)应对临时网络失败
- 记录发送日志与状态(成功/失败/退信),便于排查投递问题
- 敏感凭证(如授权码)通过环境变量或密钥管理服务注入
- 高频通知场景考虑引入消息队列(如RabbitMQ)解耦,避免阻塞主业务
不复杂但容易忽略。










