首页 > 文章 > java教程

手把手教你用JavaMail发邮件，超简单，一看就会！

时间：2025-06-17 23:48:44 400浏览收藏

还在为Java程序发送邮件烦恼吗？本文手把手教你如何使用JavaMail，让你轻松配置并发送邮件。JavaMail作为Java程序中强大的邮件发送工具，通过`Session`和`Message`对象，可以实现各种邮件需求。本文详细讲解了如何添加Maven或Gradle依赖，配置SMTP服务器地址、端口、认证方式及TLS加密等关键步骤。同时，针对常见的`AuthenticationFailedException`、`NoSuchProviderException`和中文乱码问题，提供了详细的解决方案。更进一步，介绍了如何在Spring Boot项目中集成JavaMail，简化配置流程，让你快速掌握JavaMail的使用技巧，提升开发效率。无论你是新手还是有经验的开发者，都能从中受益。

JavaMail是Java程序中用于发送邮件的工具，它通过Session对象和Message对象实现邮件发送。1.添加依赖：Maven项目在pom.xml中引入com.sun.mail:javax.mail:1.6.2，Gradle项目在build.gradle中添加implementation依赖。2.配置Session：设置SMTP服务器地址、端口、认证方式及TLS加密，并通过Authenticator提供邮箱账号和密码。3.创建Message：使用MimeMessage设置发件人、收件人、主题和内容；如需HTML邮件，用setContent方法指定text/html类型；如需附件，则通过Multipart组合正文与附件。4.发送邮件：调用Transport.send(message)完成发送。常见问题处理包括：AuthenticationFailedException需检查账号密码或SMTP服务是否开启；NoSuchProviderException需确认JavaMail版本和依赖完整性；中文乱码则应在setContent时指定charset=utf-8并确保代码文件编码一致。Spring Boot集成步骤为：1.添加spring-boot-starter-mail依赖；2.在application.properties或yml中配置邮件服务器属性；3.注入JavaMailSender并使用SimpleMailMessage或MimeMessageHelper构建并发送邮件。

Java中JavaMail的用法详解邮件发送的配置步骤

JavaMail，简单来说，就是Java程序用来发邮件的工具。它提供了一套API，让你可以在代码里轻松地配置和发送各种类型的邮件，包括带附件的、HTML格式的等等。配置步骤其实并不复杂，但涉及到一些细节，比如认证、协议选择，搞清楚了就能避免很多坑。

解决方案

JavaMail的核心在于Session对象和Message对象。Session对象代表一个邮件会话，你需要配置邮件服务器的连接信息，比如SMTP服务器地址、端口、用户名和密码。Message对象则代表你要发送的邮件，包括收件人、发件人、主题和内容。

添加JavaMail依赖:
首先，你需要将JavaMail的依赖添加到你的项目中。如果你使用Maven，可以在pom.xml文件中添加以下依赖：
```
    com.sun.mail
    javax.mail
    1.6.2
```
如果你使用Gradle，可以在build.gradle文件中添加以下依赖：
```
dependencies {
    implementation 'com.sun.mail:javax.mail:1.6.2'
}
```

配置邮件会话（Session）:

创建Session对象是第一步，你需要设置一些属性来配置邮件服务器的连接。

import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;

public class EmailSender {

    public static void main(String[] args) {
        // 配置邮件服务器属性
        Properties props = new Properties();
        props.put("mail.smtp.host", "smtp.example.com"); // SMTP服务器地址
        props.put("mail.smtp.port", "587"); // SMTP端口号，通常是587或465
        props.put("mail.smtp.auth", "true"); // 开启认证
        props.put("mail.smtp.starttls.enable", "true"); // 使用TLS加密

        // 创建Session对象
        Session session = Session.getInstance(props, new Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication("your_email@example.com", "your_password"); // 邮箱账号和密码
            }
        });

        try {
            // 创建MimeMessage对象
            Message message = new MimeMessage(session);
            message.setFrom(new InternetAddress("your_email@example.com")); // 发件人邮箱
            message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com")); // 收件人邮箱
            message.setSubject("JavaMail测试邮件"); // 邮件主题
            message.setText("这是一封JavaMail发送的测试邮件！"); // 邮件内容

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

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

        } catch (MessagingException e) {
            e.printStackTrace();
        }
    }
}

这里需要注意的是，mail.smtp.starttls.enable属性用于启用TLS加密，这对于保护你的密码非常重要。有些邮件服务器可能需要SSL加密，这时你需要使用mail.smtp.ssl.enable属性。

创建邮件消息（Message）:

创建Message对象，设置发件人、收件人、主题和内容。

Message message = new MimeMessage(session);
message.setFrom(new InternetAddress("your_email@example.com"));
message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
message.setSubject("JavaMail测试邮件");
message.setText("这是一封JavaMail发送的测试邮件！");

发送邮件:
使用Transport.send(message)方法发送邮件。
```
Transport.send(message);
```
如果你的代码运行后抛出AuthenticationFailedException，那很可能是你的邮箱账号或密码不正确，或者你没有开启SMTP服务。
发送HTML邮件:
如果你想发送HTML格式的邮件，可以使用setContent方法，并指定MIME类型为text/html。
```
message.setContent("这是一封HTML格式的邮件！
JavaMail真好用！
", "text/html; charset=utf-8");
```

发送带附件的邮件:

发送带附件的邮件稍微复杂一些，你需要使用Multipart对象来组合邮件内容和附件。

MimeMessage message = new MimeMessage(session);
message.setFrom(new InternetAddress("your_email@example.com"));
message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
message.setSubject("JavaMail带附件的邮件");

// 创建Multipart对象
Multipart multipart = new MimeMultipart();

// 创建邮件正文
MimeBodyPart textPart = new MimeBodyPart();
textPart.setContent("这是一封带附件的邮件！", "text/html; charset=utf-8");
multipart.addBodyPart(textPart);

// 创建附件
MimeBodyPart attachmentPart = new MimeBodyPart();
DataSource source = new FileDataSource("path/to/your/attachment.pdf"); // 附件路径
attachmentPart.setDataHandler(new DataHandler(source));
attachmentPart.setFileName("attachment.pdf"); // 附件名称
multipart.addBodyPart(attachmentPart);

message.setContent(multipart);

Transport.send(message);

JavaMail 常见异常如何处理？

常见的异常包括MessagingException、AuthenticationFailedException、NoSuchProviderException等。MessagingException是所有邮件异常的基类，你需要根据具体的错误信息来判断问题所在。AuthenticationFailedException通常是由于认证失败引起的，你需要检查你的邮箱账号和密码是否正确，以及是否开启了SMTP服务。NoSuchProviderException表示找不到指定的协议提供者，这可能是由于你的JavaMail版本过低或者缺少相关的依赖库引起的。

如何解决 JavaMail 发送邮件时中文乱码问题？

中文乱码问题通常是由于字符编码不一致引起的。你需要在设置邮件内容时，指定字符编码为utf-8。例如：

message.setContent("这是一封HTML格式的邮件！
JavaMail真好用！
", "text/html; charset=utf-8");

另外，你还需要确保你的代码文件的字符编码也是utf-8。

JavaMail 如何集成 Spring Boot？

Spring Boot 提供了对 JavaMail 的自动配置，你可以通过简单的配置就可以在 Spring Boot 项目中使用 JavaMail。

添加依赖:

在pom.xml文件中添加以下依赖：


    org.springframework.boot
    spring-boot-starter-mail

配置邮件服务器属性:

在application.properties或application.yml文件中配置邮件服务器属性：

spring.mail.host=smtp.example.com
spring.mail.port=587
spring.mail.username=your_email@example.com
spring.mail.password=your_password
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true

使用 JavaMailSender 发送邮件:

在你的代码中注入JavaMailSender对象，然后使用它来发送邮件。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;

@Service
public class EmailService {

    @Autowired
    private JavaMailSender mailSender;

    public void sendSimpleMessage(String to, String subject, String text) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom("your_email@example.com");
        message.setTo(to);
        message.setSubject(subject);
        message.setText(text);
        mailSender.send(message);
    }
}

这样，你就可以在 Spring Boot 项目中轻松地使用 JavaMail 发送邮件了。

今天关于《手把手教你用JavaMail发邮件，超简单，一看就会！》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！

SpringBoot session 邮件发送 JavaMail Message