登录注册

当前位置：首页 > 文章列表 > 文章 > java教程 > Java发送邮件教程及代码实例

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

2025-07-21 19:33:13 0浏览 收藏

你在学习文章相关的知识吗？本文《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学习网公众号吧！

Java字符串比较方法全解析Java字符串比较方法全解析
上一篇
Java字符串比较方法全解析
Golang版本控制怎么用模块管理详解
下一篇
Golang版本控制怎么用模块管理详解
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案，代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景，打造一站式知识长龙服务，适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例，全面具体可落地，从理论到实践，一步一步将GO核心编程技术、编程思想、底层实现融会贯通，使学习者贴近时代脉搏，做IT互联网时代的弄潮儿。
    511次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信：Le-studyg；在课程中，我们将首先介绍MySQL8的新特性，包括性能优化、安全增强、新数据类型等，帮助学生快速熟悉MySQL8的最新功能。接着，我们将深入解析MySQL的网络通信机制，包括协议、连接管理、数据传输等，让
    498次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网，分为导航，轮播，关于我们，成功案例，服务流程，团队介绍，数据部分，公司动态，底部信息等内容区块。网站整体采用CSSGrid布局，支持响应式，有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • 满分语法：免费在线英语语法检查器 | 论文作文邮件一键纠错润色
    满分语法
    满分语法是一款免费在线英语语法检查器，助您一键纠正所有英语语法、拼写、标点错误及病句。支持论文、作文、翻译、邮件语法检查与文本润色，并提供详细语法讲解，是英语学习与使用者必备工具。
    9次使用
  • 易销AI：跨境电商AI营销专家 | 高效文案生成，敏感词规避，多语言覆盖
    易销AI-专为跨境
    易销AI是专为跨境电商打造的AI营销神器，提供多语言广告/产品文案高效生成、精准敏感词规避，并配备定制AI角色，助力卖家提升全球市场广告投放效果与回报率。
    11次使用
  • WisFile：免费AI本地文件批量重命名与智能归档工具
    WisFile-批量改名
    WisFile是一款免费AI本地工具，专为解决文件命名混乱、归类无序难题。智能识别关键词，AI批量重命名，100%隐私保护，让您的文件井井有条，触手可及。
    9次使用
  • 曦灵数字人：AI视频、直播、2D/3D超写实数字人克隆与生成
    曦灵数字人
    曦灵数字人平台：提供AI视频、直播、2D/3D超写实数字人及声音克隆服务。3分钟快速克隆，5分钟生成3D数字人，助力高效智能内容创作与营销。
    7次使用
  • 字加AI：智能字体管理与获取，高效设计利器
    字加AI
    字加AI：您的智能字体管家，高效整合字体获取、使用与管理功能，赋能设计创意，提升工作效率。
    11次使用
查看更多
相关文章
关于我们 免责声明 意见反馈 联系我们 内容提交
Golang学习网：公益在线Go学习平台，帮助Go学习者快速成长！
技术交流群
Copyright 2023 http://www.17golang.com/ All Rights Reserved ｜ 苏ICP备2023003363号-1
  • Golang学习网
    关注公众号
    Golang学习网
微信登录更方便
  • 密码登录
  • 注册账号
忘记密码
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码
发送验证码