首页 > 软件编程 > java > SpringBoot邮件发送功能

SpringBoot实现邮件发送功能的详细步骤(普通邮件、HTML邮件、附件邮件)

2026-07-15 08:36:34 作者：张老师技术栈

还在为SpringBoot邮件发送发愁,本文手把手教你配置JavaMail,轻松搞定文本、HTML、附件和内联图片邮件,掌握Thymeleaf模板和异步批量发送技巧,避开535、554等常见错误,让你的系统通知、验证码推送更高效,需要的朋友可以参考下

邮件发送是后端系统的常见功能——注册验证码、系统告警、周报推送。SpringBoot 封装了 JavaMail，配置简单，API 友好。

一、配置

1. 引入依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

2. 邮箱配置

spring:
  mail:
    host: smtp.qq.com
    port: 465
    username: your_email@qq.com
    password: 你的授权码  # 不是QQ密码，是SMTP授权码
    properties:
      mail:
        smtp:
          auth: true
          ssl:
            enable: true
          socketFactory:
            port: 465
            class: javax.net.ssl.SSLSocketFactory

授权码获取：QQ邮箱 → 设置 → 账号 → 开启SMTP服务 → 生成授权码

二、发送邮件

1. 简单文本邮件

@Service
public class MailService {

    @Autowired
    private JavaMailSender mailSender;

    @Value("${spring.mail.username}")
    private String from;

    public void sendSimpleMail(String to, String subject, String content) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(from);
        message.setTo(to);
        message.setSubject(subject);
        message.setText(content);
        mailSender.send(message);
    }
}

2. HTML 邮件

public void sendHtmlMail(String to, String subject, String htmlContent)
        throws MessagingException {
    MimeMessage message = mailSender.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
    helper.setFrom(from);
    helper.setTo(to);
    helper.setSubject(subject);
    helper.setText(htmlContent, true);  // true = HTML 格式
    mailSender.send(message);
}

HTML 内容示例：

String html = "<div style='padding:20px;max-width:600px;margin:0 auto'>"
    + "<h2 style='color:#e74c3c'>秒杀成功通知</h2>"
    + "<p>亲爱的用户：</p>"
    + "<p>您在秒杀活动中抢购的商品已成功下单！</p>"
    + "<table border='1' cellpadding='8' style='border-collapse:collapse'>"
    + "<tr><td>订单号</td><td>" + orderNo + "</td></tr>"
    + "<tr><td>商品名称</td><td>iPhone 15</td></tr>"
    + "<tr><td>金额</td><td>¥4999</td></tr>"
    + "</table>
<p>祝您购物愉快！</p></div>";

3. 带附件邮件

public void sendAttachmentMail(String to, String subject,
                                String content, String filePath)
        throws MessagingException {
    MimeMessage message = mailSender.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
    helper.setFrom(from);
    helper.setTo(to);
    helper.setSubject(subject);
    helper.setText(content);

    // 添加附件
    File file = new File(filePath);
    helper.addAttachment(file.getName(), file);

    mailSender.send(message);
}

4. 带内联图片

public void sendInlineImageMail(String to, String subject,
                                  String content, String imgPath)
        throws MessagingException {
    MimeMessage message = mailSender.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
    helper.setFrom(from);
    helper.setTo(to);
    helper.setSubject(subject);
    helper.setText(
        "<html><body><img src='cid:image1'/><p>" + content + "</p></body></html>",
        true
    );

    FileSystemResource img = new FileSystemResource(new File(imgPath));
    helper.addInline("image1", img);

    mailSender.send(message);
}

三、模板邮件

1. 使用 Thymeleaf 模板

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

<!-- resources/templates/mail/welcome.html -->
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<body>
    <h2 th:text="'欢迎 ' + ${username} + ' 加入！'">欢迎加入</h2>
    <p>请点击以下链接激活账户：</p>
    <a th:href="${activateUrl}" rel="external nofollow" >激活账户</a>
    <p th:text="'链接有效期：' + ${expireHours} + ' 小时'">有效期</p>
</body>
</html>

@Service
public class TemplateMailService {

    @Autowired
    private JavaMailSender mailSender;

    @Autowired
    private TemplateEngine templateEngine;

    @Value("${spring.mail.username}")
    private String from;

    public void sendTemplateMail(String to, String subject,
                                  Map<String, Object> params)
            throws MessagingException {
        // 渲染模板
        Context context = new Context();
        context.setVariables(params);
        String html = templateEngine.process("mail/welcome.html", context);

        // 发送
        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
        helper.setFrom(from);
        helper.setTo(to);
        helper.setSubject(subject);
        helper.setText(html, true);
        mailSender.send(message);
    }
}

四、批量发送

public void sendBatch(List<String> toList, String subject,
                       String content) {
    for (String to : toList) {
        try {
            sendSimpleMail(to, subject, content);
            // 每封间隔 3 秒，避免被判定为垃圾邮件
            Thread.sleep(3000);
        } catch (Exception e) {
            log.error("发送失败: {}", to, e);
        }
    }
}

五、异步发送

@Service
public class AsyncMailService {

    @Async("taskExecutor")
    public void sendMailAsync(String to, String subject, String content) {
        mailService.sendSimpleMail(to, subject, content);
        log.info("邮件已异步发送: {}", to);
    }
}

六、常见问题

1. 535 Error：登录失败

# 原因：用了QQ密码而不是授权码
# 解决：去QQ邮箱 → 设置 → 账号 → 生成授权码
spring:
  mail:
    password: 你的授权码  # 不是QQ密码

2. 554 被判定为垃圾邮件

// 原因：邮件内容太短或太模板化
// 解决：
//   - 内容不要太雷同
//   - 加收件人姓名个性化
//   - 控制发送频率（每分钟不超过 10 封）

3. 发送超时

spring:
  mail:
    properties:
      mail:
        smtp:
          connectiontimeout: 5000
          timeout: 5000
          writetimeout: 5000

七、秒杀系统应用

@Service
public class SeckillMailService {

    @Async("taskExecutor")
    public void notifySeckillResult(Long userId, String productName,
                                     boolean success, String orderNo) {
        Map<String, Object> params = new HashMap<>();
        params.put("userId", userId);
        params.put("productName", productName);
        params.put("success", success);
        params.put("orderNo", orderNo);

        templateMailService.sendTemplateMail(
            "user@example.com",
            "秒杀结果通知",
            params
        );
    }
}

总结

发送方式：
  简单文本 → SimpleMailMessage
  HTML内容 → MimeMessageHelper(true)
  带附件   → helper.addAttachment()
  内联图片 → helper.addInline()

注意事项：
  使用授权码而非密码
  控制发送频率
  异步发送不影响主流程

到此这篇关于SpringBoot实现邮件发送功能的详细步骤(普通邮件、HTML邮件、附件邮件)的文章就介绍到这了,更多相关SpringBoot邮件发送功能内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！