Java案例怎么推送邮件消息？

本文目录导读：

1. 准备工作：引入依赖
2. 案例一：发送纯文本邮件（最基础）
3. 案例二：发送HTML邮件（带样式）
4. 案例三：发送带附件的邮件
5. 案例四：使用Spring Boot发送邮件（企业级推荐）
6. 常见问题与排查

在Java中推送邮件消息,最经典、最常用的方式是使用 JavaMail API（jakarta.mail 或 javax.mail）。

以下我会给出几个核心的案例,从最基础的文本邮件，到带附件、HTML内容的邮件，以及基于Spring Boot的集成方式。

准备工作：引入依赖

根据你项目的构建工具和Jakarta命名空间,选择合适的依赖。

Maven（Jakarta Mail 2.x，适用于Spring Boot 3.x / Jakarta EE 9+）

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>jakarta.mail</artifactId>
    <version>2.0.1</version>
</dependency>

Maven（javax.mail，适用于Spring Boot 2.x / 传统项目）

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

提示：如果你想快速测试，建议使用QQ邮箱或163邮箱的SMTP服务，需要先去邮箱设置里开启“SMTP服务”并获取授权码（不是登录密码）。

发送纯文本邮件（最基础）

这个例子展示了如何使用JavaMail API发送一封简单的文本邮件。

import jakarta.mail.*;
import jakarta.mail.internet.InternetAddress;
import jakarta.mail.internet.MimeMessage;
import java.util.Properties;
public class SendTextEmail {
    public static void main(String[] args) {
        // 1. 配置邮件服务器属性
        Properties props = new Properties();
        props.put("mail.smtp.auth", "true");                 // 需要身份验证
        props.put("mail.smtp.host", "smtp.qq.com");          // SMTP服务器地址 (QQ邮箱)
        props.put("mail.smtp.port", "587");                  // 端口: 587 (TLS) 或 465 (SSL)
        props.put("mail.smtp.starttls.enable", "true");      // 启用TLS加密
        // 2. 创建Session对象（代表邮件会话）
        //    发件人邮箱地址和授权码
        final String username = "your_email@qq.com";
        final String password = "your_authorization_code"; // 这里是授权码，不是登录密码
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(username, password);
            }
        });
        try {
            // 3. 创建邮件消息
            Message message = new MimeMessage(session);
            message.setFrom(new InternetAddress(username));                  // 发件人
            message.setRecipients(Message.RecipientType.TO,
                    InternetAddress.parse("recipient@example.com"));        // 收件人
            message.setSubject("Java邮件测试");                             // 主题
            message.setText("这是一封来自Java的测试邮件。\nHello World!");   // 正文（纯文本）
            // 4. 发送邮件
            Transport.send(message);
            System.out.println("邮件发送成功！");
        } catch (MessagingException e) {
            e.printStackTrace();
            System.err.println("邮件发送失败: " + e.getMessage());
        }
    }
}

发送HTML邮件（带样式）

如果你想让邮件更美观（比如包含表格、图片、链接），可以使用setContent方法设置HTML格式。

// ... 前面的Session创建代码与案例一相同 ...
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress(username));
message.setRecipients(Message.RecipientType.TO,
        InternetAddress.parse("recipient@example.com"));
message.setSubject("HTML格式的邮件");
// 关键点：设置HTML内容
String htmlContent = "<h1 style='color:blue;'>这是一个标题</h1>" +
        "<p>这是一段<b>加粗</b>的文字。</p>" +
        "<a href='https://www.baidu.com'>点击访问百度</a>";
message.setContent(htmlContent, "text/html; charset=UTF-8");
Transport.send(message);

发送带附件的邮件

需要用到MimeMultipart组合邮件内容。

import jakarta.mail.internet.MimeBodyPart;
import jakarta.mail.internet.MimeMultipart;
import jakarta.activation.DataHandler;
import jakarta.activation.FileDataSource;
// ... 前面的Session创建代码 ...
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress(username));
message.setRecipients(Message.RecipientType.TO,
        InternetAddress.parse("recipient@example.com"));
message.setSubject("带附件的测试邮件");
// 1. 创建邮件正文部分
MimeBodyPart textPart = new MimeBodyPart();
textPart.setText("请查收附件中的文件。");
textPart.setContent("请查收附件中的文件。<br><b>这是HTML内容</b>", "text/html; charset=UTF-8");
// 2. 创建附件部分
MimeBodyPart attachmentPart = new MimeBodyPart();
// 假设本地有一个文件
FileDataSource fds = new FileDataSource("/path/to/your/file.txt");
attachmentPart.setDataHandler(new DataHandler(fds));
attachmentPart.setFileName(fds.getName()); // 设置附件显示的名称
// 3. 组合成 Multipart
MimeMultipart multipart = new MimeMultipart();
multipart.addBodyPart(textPart);
multipart.addBodyPart(attachmentPart);
// 4. 设置邮件内容
message.setContent(multipart);
Transport.send(message);

使用Spring Boot发送邮件（企业级推荐）

如果你使用Spring Boot，集成邮件发送非常简单，代码量也大大减少。

添加依赖（Spring Boot Starter Mail）

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

配置文件 (application.yml)

spring:
  mail:
    host: smtp.qq.com
    port: 587
    username: your_email@qq.com
    password: your_authorization_code
    properties:
      mail:
        smtp:
          auth: true
          starttls:
            enable: true

编写发送邮件的Service

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
import jakarta.mail.MessagingException;
import jakarta.mail.internet.MimeMessage;
import java.io.File;
@Service
public class EmailService {
    @Autowired
    private JavaMailSender mailSender;
    // 发送简单文本邮件
    public void sendSimpleEmail(String to, String subject, String text) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setTo(to);
        message.setSubject(subject);
        message.setText(text);
        message.setFrom("your_email@qq.com"); // 可选，默认使用配置中的username
        mailSender.send(message);
    }
    // 发送HTML邮件或带附件的邮件
    public void sendMimeEmail(String to, String subject, String htmlContent,
                              File attachment, String attachmentName) throws MessagingException {
        MimeMessage message = mailSender.createMimeMessage();
        // true 表示需要构建 multipart 消息（支持附件和内联资源）
        MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
        helper.setTo(to);
        helper.setSubject(subject);
        helper.setText(htmlContent, true); // true 表示是HTML
        // 添加附件
        if (attachment != null) {
            helper.addAttachment(attachmentName, attachment);
        }
        mailSender.send(message);
    }
}

在Controller中调用

@RestController
public class EmailController {
    @Autowired
    private EmailService emailService;
    @GetMapping("/send")
    public String send() {
        emailService.sendSimpleEmail("recipient@example.com", "Spring Boot 邮件", "您好，这是Spring Boot发送的邮件。");
        return "发送成功";
    }
}

常见问题与排查

• 快速开发：使用Spring Boot的JavaMailSender。
• 底层控制：直接使用JavaMail API，适合需要精细控制的场景（如自定义连接池）。
• 安全性：建议使用TLS/SSL加密（starttls.enable=true 或 mail.smtp.socketFactory.port=465）。
• 授权码：始终使用邮箱的授权码，不要泄露你的邮箱密码。