登录
首页 >  文章 >  java教程

Java发送邮件教程及代码实例

时间：2025-10-12 19:26:27 233浏览 收藏

想要用Java发送邮件？本文将带你一步步掌握JavaMail API的使用技巧，轻松实现邮件发送功能。首先，你需要引入JavaMail依赖，配置SMTP服务器信息，例如host、port以及认证方式。接着，创建Session对象与邮件服务器建立会话，并构建MimeMessage对象，设置发件人、收件人、主题和邮件内容。最后，通过Transport类发送邮件。如果需要发送HTML内容或附件，可以使用MimeMultipart和MimeBodyPart组合邮件内容。此外，本文还整理了常见的认证失败、连接超时等问题，并提供了相应的解决方案。对于Spring Boot项目，通过引入spring-boot-starter-mail模块，结合JavaMailSender和MimeMessageHelper，能更优雅地实现邮件发送。掌握这些技巧，让你的Java应用也能轻松实现邮件发送功能。

要使用Java发送邮件，核心是利用JavaMail API，步骤如下：1. 引入JavaMail依赖，如在Maven项目中添加对应dependency；2. 配置SMTP服务器信息，包括host、port、认证方式等；3. 创建Session对象，用于与邮件服务器建立会话；4. 构建MimeMessage对象，设置发件人、收件人、主题和内容；5. 使用Transport类发送邮件。若需发送HTML内容或附件，需使用MimeMultipart和MimeBodyPart组合邮件内容。常见问题如认证失败、连接超时、SSL/TLS握手失败等，需检查用户名密码、网络配置及证书设置。在Spring Boot项目中，可通过引入spring-boot-starter-mail模块并配置邮件属性，结合JavaMailSender和MimeMessageHelper简化邮件发送流程，实现更优雅的集成。

如何用Java发送邮件 Java发送邮件的步骤与示例

用Java发送邮件，核心在于利用JavaMail API，它提供了一套标准接口来处理邮件的发送、接收和管理。你只需要配置好SMTP服务器信息，构建邮件内容，然后通过Transport类就能轻松发送出去。这听起来可能有点技术性，但实际操作起来，步骤是相当清晰的。

如何用Java发送邮件 Java发送邮件的步骤与示例

解决方案

其实，用Java发邮件这事儿，核心就是那么几步，它依赖于JavaMail API。首先，你得把JavaMail的库引入到你的项目里，如果你用Maven，那就在pom.xml里加：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>jakarta.mail</artifactId>
    <version>2.0.1</version> <!-- 或者更高版本，根据你项目需求来 -->
</dependency>
<dependency>
    <groupId>jakarta.activation</groupId>
    <artifactId>jakarta.activation-api</artifactId>
    <version>2.0.1</version>
</dependency>

接着，就是编写发送邮件的代码了。我个人觉得，最关键的是理解邮件会话（Session）和邮件内容（MimeMessage）这两个概念。

如何用Java发送邮件 Java发送邮件的步骤与示例
import jakarta.mail.*;
import jakarta.mail.internet.*;
import java.util.Properties;

public class EmailSender {

    public static void main(String[] args) {
        // 1. 配置邮件服务器属性
        // 这一步就像告诉你的程序，你要通过哪个邮局（SMTP服务器）寄信
        Properties props = new Properties();
        props.put("mail.smtp.host", "smtp.example.com"); // 替换为你的SMTP服务器地址，例如smtp.qq.com, smtp.gmail.com
        props.put("mail.smtp.port", "587"); // SMTP端口，通常是25, 465(SSL), 587(TLS)
        props.put("mail.smtp.auth", "true"); // 需要认证
        props.put("mail.smtp.starttls.enable", "true"); // 启用TLS加密

        // 如果是SSL/TLS端口，比如Gmail的465，可能需要这样配置
        // props.put("mail.smtp.socketFactory.port", "465");
        // props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
        // props.put("mail.smtp.ssl.enable", "true"); // 启用SSL

        // 2. 创建Session对象
        // Session就像你和邮局之间建立的一个会话，通过它来处理所有的邮件操作
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                // 替换为你的邮箱地址和授权码（或密码）
                // 很多邮箱服务为了安全，需要使用授权码而非登录密码
                return new PasswordAuthentication("your_email@example.com", "your_authorization_code");
            }
        });

        // 开启调试模式，可以看到更详细的发送过程日志，排查问题很有用
        // session.setDebug(true);

        try {
            // 3. 创建MimeMessage对象
            // 这就是你要发送的那封信了，可以设置发件人、收件人、主题、内容等等
            MimeMessage message = new MimeMessage(session);

            // 设置发件人
            message.setFrom(new InternetAddress("your_email@example.com"));

            // 设置收件人
            // To: 主要收件人
            message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient_email@example.com"));
            // Cc: 抄送
            // message.setRecipients(Message.RecipientType.CC, InternetAddress.parse("cc_email@example.com"));
            // Bcc: 密送
            // message.setRecipients(Message.RecipientType.BCC, InternetAddress.parse("bcc_email@example.com"));

            // 设置邮件主题
            message.setSubject("Java发送邮件测试 - " + System.currentTimeMillis());

            // 设置邮件内容
            // 默认是纯文本
            message.setText("你好，这是一封通过Java程序发送的测试邮件。希望你能收到！");

            // 4. 发送邮件
            // Transport就是那个帮你把信寄出去的“邮递员”
            Transport.send(message);

            System.out.println("邮件发送成功！");

        } catch (MessagingException e) {
            // 捕获发送过程中可能出现的异常
            System.err.println("邮件发送失败：" + e.getMessage());
            e.printStackTrace();
        }
    }
}

这段代码，基本上涵盖了邮件发送的骨架。你需要做的就是替换那些占位符，比如SMTP服务器地址、端口、你的邮箱和授权码，以及收件人地址。我特别强调一下“授权码”这东西，现在很多邮箱服务，比如QQ邮箱、Gmail等，出于安全考虑，不再允许直接使用登录密码进行SMTP认证，而是需要你生成一个“授权码”或“应用专用密码”。这个在你的邮箱设置里通常能找到。

JavaMail API发送邮件时如何处理附件和HTML内容？

发送纯文本邮件固然简单，但在实际应用中，我们经常需要发送带有格式的HTML邮件，或者附带文件。JavaMail API当然考虑到了这一点，它通过MimeMultipart和MimeBodyPart来优雅地处理这些复杂场景。这就像你要寄一封信，信里不仅有文字，还想塞一张照片进去，或者信纸本身就是彩色的、有排版的。

如何用Java发送邮件 Java发送邮件的步骤与示例

要发送HTML内容，你只需要在设置邮件内容时，指定其MIME类型为text/html：

// ... (前面的Session和MimeMessage创建保持不变) ...

// 设置HTML邮件内容
String htmlContent = "<h1>你好！</h1>"
                   + "<p>这是一封<b>HTML</b>格式的测试邮件，通过Java发送。</p>"
                   + "<p>希望你能看到漂亮的排版和加粗的文字！</p>"
                   + "<img src='https://example.com/some_image.png' alt='示例图片' width='100' height='100'>"; // 也可以包含图片链接
message.setContent(htmlContent, "text/html; charset=utf-8"); // 明确指定内容类型和字符编码

// ... (后续的Transport.send(message)保持不变) ...

至于附件，那就稍微复杂一点点，但逻辑也很直观。你需要创建一个MimeMultipart对象作为邮件的“主体”，然后把文本内容和附件都作为MimeBodyPart添加到这个主体里。

import jakarta.activation.DataHandler;
import jakarta.activation.DataSource;
import jakarta.activation.FileDataSource;
// ... 其他导入 ...

// ... (前面的Session和MimeMessage创建保持不变) ...

try {
    MimeMessage message = new MimeMessage(session);
    // ... 设置发件人、收件人、主题 ...

    // 创建一个MimeMultipart对象，用于组合邮件的不同部分（文本、附件）
    Multipart multipart = new MimeMultipart();

    // 1. 添加邮件正文（可以是纯文本或HTML）
    BodyPart messageBodyPart = new MimeBodyPart();
    String htmlContent = "<h1>你好！</h1>"
                       + "<p>这是一封带有<b>附件</b>的测试邮件，通过Java发送。</p>"
                       + "<p>请查收附件。</p>";
    messageBodyPart.setContent(htmlContent, "text/html; charset=utf-8");
    multipart.addBodyPart(messageBodyPart);

    // 2. 添加附件
    messageBodyPart = new MimeBodyPart();
    String filename = "/path/to/your/file.pdf"; // 替换为你要发送的文件路径
    DataSource source = new FileDataSource(filename);
    messageBodyPart.setDataHandler(new DataHandler(source));
    messageBodyPart.setFileName(source.getName()); // 设置附件的文件名
    multipart.addBodyPart(messageBodyPart);

    // 如果想添加多个附件，重复上述“添加附件”的步骤即可

    // 将MimeMultipart对象设置为邮件的内容
    message.setContent(multipart);

    // 4. 发送邮件
    Transport.send(message);

    System.out.println("带附件和HTML内容的邮件发送成功！");

} catch (MessagingException e) {
    System.err.println("邮件发送失败：" + e.getMessage());
    e.printStackTrace();
}

这里有个小细节，FileDataSource是用于从文件系统读取数据源的，如果你想从其他地方（比如内存中的字节数组）作为附件，可以考虑实现自己的DataSource。我个人觉得，这种分层组合的方式，虽然代码量多了一点，但逻辑上非常清晰，便于管理邮件的复杂结构。

JavaMail API发送邮件时常见的错误和解决方案有哪些？

在用JavaMail API发送邮件的过程中，我遇到过不少“坑”。这些问题往往不是代码逻辑上的错误，而是配置、网络或者邮件服务商策略导致的。理解这些常见问题及其解决方案，能让你在遇到困难时少走很多弯路。

  1. 认证失败 (Authentication Failed):

    • 问题描述: 收到 AuthenticationFailedException，通常提示用户名或密码错误。
    • 解决方案:
      • 检查用户名和密码/授权码: 确保你提供的邮箱地址和授权码（或密码）是正确的。很多邮箱服务（如Gmail、QQ邮箱、163邮箱）为了安全，需要你开启SMTP服务并生成一个“授权码”或“应用专用密码”来代替登录密码。
      • 检查SMTP服务器是否开启: 确保你的邮箱服务商已经允许SMTP客户端发送邮件。
      • 网络连接: 确认你的服务器或本地机器可以访问邮件服务商的SMTP服务器。

  2. 连接超时或无法连接 (Connection Timeout/Could not connect to SMTP host):

    • 问题描述: 出现 ConnectException 或 SocketTimeoutException，提示无法连接到SMTP主机或连接超时。
    • 解决方案:
      • 检查SMTP主机地址和端口: 确保 mail.smtp.host 和 mail.smtp.port 配置正确。例如，Gmail的SMTP是smtp.gmail.com，端口通常是587（TLS）或465（SSL）。
      • 防火墙问题: 检查你的服务器或本地机器的防火墙是否阻止了对SMTP端口的传出连接。
      • 网络问题: 确认网络连接稳定，DNS解析正常。可以尝试 ping smtp.example.com 或 telnet smtp.example.com 587 来测试连通性。

  3. SSL/TLS握手失败 (SSL/TLS Handshake Failure):

    • 问题描述: 出现与SSL/TLS相关的错误，例如 PKIX path building failed 或 Could not convert socket to TLS。
    • 解决方案:
      • SSL/TLS配置: 确保 mail.smtp.starttls.enable 设置为 true (对于587端口) 或 mail.smtp.ssl.enable 设置为 true (对于465端口)。
      • 证书问题: 有时是Java环境的CA证书库缺少了SMTP服务器的证书。这在生产环境中较少见，但在某些自签名证书或企业内部邮件服务器上可能发生。确保Java的cacerts文件是最新的，或者手动导入证书。
      • Java版本: 确保你的Java版本支持所需的TLS协议版本。

  4. 邮件地址格式不正确 (Invalid Address):

    • 问题描述: 出现 AddressException，提示邮件地址格式不合法。
    • 解决方案:
      • 检查邮件地址: 确保所有发件人、收件人、抄送、密送地址都符合标准的邮件格式，例如 user@domain.com。

  5. 字符编码问题 (Garbled Characters):

    • 问题描述: 邮件内容在收件人端显示乱码。
    • 解决方案:
      • 明确指定编码: 在设置邮件内容时，务必指定字符编码，例如 message.setText(content, "utf-8") 或 message.setContent(htmlContent, "text/html; charset=utf-8")。统一使用UTF-8是一个好习惯。

调试小技巧: 我个人强烈推荐在开发阶段开启JavaMail的调试模式，这能让你看到非常详细的SMTP会话日志，包括客户端和服务端之间的每一条命令和响应。这对于诊断连接、认证或传输问题非常有帮助。

session.setDebug(true); // 在创建Session后添加这行

通过观察这些日志，你通常能快速定位问题所在。比如，看到535 Authentication Failed就明确是认证问题，看到220 Service ready但后面没动静，可能就是防火墙或连接阻塞了。

在Spring Boot项目中如何更优雅地集成Java邮件发送功能？

如果你正在使用Spring Boot，那么恭喜你，发送邮件这事儿会变得异常简单和优雅。Spring Boot提供了一个spring-boot-starter-mail模块，它自动配置了JavaMailSender，让你几乎不用关心JavaMail API的底层细节。我个人觉得，这是Spring Boot最让人省心的地方之一。

首先，在你的pom.xml里引入这个Starter：

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

接着，在application.properties或application.yml中配置邮件服务器信息。这些配置项Spring Boot会自动识别并用来创建JavaMailSender实例：

# application.properties
spring.mail.host=smtp.example.com
spring.mail.port=587
spring.mail.username=your_email@example.com
spring.mail.password=your_authorization_code
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true # 有些服务器需要
# spring.mail.properties.mail.smtp.ssl.enable=true # 如果使用SSL，如465端口

然后，你就可以在你的服务类中直接注入JavaMailSender，并使用它来发送邮件了。Spring提供了一个MimeMessageHelper，它比直接操作MimeMessage要方便得多，尤其是在处理HTML内容和附件时。

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;
import java.nio.charset.StandardCharsets;

@Service
public class EmailService {

    private final JavaMailSender mailSender;

    // Spring会自动注入JavaMailSender
    public EmailService(JavaMailSender mailSender) {
        this.mailSender = mailSender;
    }

    public void sendSimpleEmail(String to, String subject, String content) {
        try {
            MimeMessage message = mailSender.createMimeMessage();
            MimeMessageHelper helper = new MimeMessageHelper(message, true, StandardCharsets.UTF_8.name()); // true表示支持multipart/附件

            helper.setFrom("your_email@example.com"); // 发件人
            helper.setTo(to); // 收件人
            helper.setSubject(subject); // 主题
            helper.setText(content, true); // true表示内容是HTML

            // 如果要添加附件
            // File attachment = new File("/path/to/your/file.pdf");
            // helper.addAttachment(attachment.getName(), attachment);

            mailSender.send(message);
            System.out.println("邮件发送成功 (Spring Boot)！");
        } catch (MessagingException e) {
            System.err.println("邮件发送失败 (Spring Boot)：" + e.getMessage());
            e.printStackTrace();
        }
    }

    // 示例：在某个地方调用
    public static void main(String[] args) {
        // 这部分需要在Spring Boot应用上下文中运行
        // 例如，在你的Application类中或者一个测试类中
        // SpringApplication.run(YourApplication.class, args);
        // EmailService emailService = context.getBean(EmailService.class);
        // emailService.sendSimpleEmail("recipient_email@example.com", "Spring Boot邮件测试", "<h1>Hello from Spring Boot!</h1><p>This is a test email.</p>");
    }
}

我个人非常喜欢MimeMessageHelper，它把很多繁琐的MimeBodyPart和MimeMultipart操作都封装起来了，让发送复杂邮件变得非常直观。另外，在生产环境中，你可能还会考虑异步发送邮件，避免邮件发送的耗时操作阻塞主线程。Spring Boot可以配合@Async注解轻松实现异步发送，这对于提升用户体验和系统响应速度是很有价值的。你只需要在配置类上启用@EnableAsync，然后在发送邮件的方法上加上@Async即可。这种集成方式，无疑让邮件服务成为Spring Boot应用中一个非常自然且强大的组成部分。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java发送邮件教程及代码实例》文章吧，也可关注golang学习网公众号了解相关技术文章。

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>