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免费学习笔记（深入）”；
<dependency> <groupId>jakarta.mail</groupId> <artifactId>jakarta.mail-api</artifactId> <version>2.1.3</version> </dependency> <dependency> <groupId>com.sun.mail</groupId> <artifactId>jakarta.mail</artifactId> <version>2.0.1</version> </dependency>
发送纯文本邮件示例：
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：
- 用
MimeBodyPart分别封装HTML正文和附件 - 设置
Content-ID可内嵌图片（如邮件Logo） - 附件建议使用
Base64编码或直接读取FileDataSource
常见问题：中文乱码需统一设置setHeader("Content-Transfer-Encoding", "base64")并指定字符集为UTF-8；大附件注意超时和内存占用，建议异步发送+流式上传。
生产环境注意事项
真实项目中不能裸写发送逻辑，需封装成可配置、可监控的服务：
- 将SMTP配置抽离到
application.yml或配置中心 - 添加重试机制（如Spring Retry）应对临时网络失败
- 记录发送日志与状态（成功/失败/退信），便于排查投递问题
- 敏感凭证（如授权码）通过环境变量或密钥管理服务注入
- 高频通知场景考虑引入消息队列（如RabbitMQ）解耦，避免阻塞主业务
不复杂但容易忽略。
