在Java中实现邮件通知服务_JavaSMTP项目实战说明

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):


  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

  • MimeBodyPart分别封装HTML正文和附件
  • 设置Content-ID可内嵌图片(如邮件Logo)
  • 附件建议使用Base64编码或直接读取FileDataSource

常见问题:中文乱码需统一设置setHeader("Content-Transfer-Encoding", "base64")并指定字符集为UTF-8;大附件注意超时和内存占用,建议异步发送+流式上传。

生产环境注意事项

真实项目中不能裸写发送逻辑,需封装成可配置、可监控的服务:

  • 将SMTP配置抽离到application.yml或配置中心
  • 添加重试机制(如Spring Retry)应对临时网络失败
  • 记录发送日志与状态(成功/失败/退信),便于排查投递问题
  • 敏感凭证(如授权码)通过环境变量或密钥管理服务注入
  • 高频通知场景考虑引入消息队列(如RabbitMQ)解耦,避免阻塞主业务

不复杂但容易忽略。