当前位置：首页 > 文章列表 > 文章 > java教程 > Java发送邮件带附件详细教程

Java发送邮件带附件详细教程

2025-07-13 18:43:44 0浏览收藏

想要掌握Java邮件发送附件的技巧吗？本文为你提供一份详尽的教程，助你轻松实现邮件附件的完整处理。文章深入讲解了如何利用JavaMail API中的MimeBodyPart和MimeMultipart，从设置邮件会话、创建MimeMessage对象，到添加邮件正文和附件，每一步都进行了详细的阐述。同时，还重点介绍了如何避免附件文件名乱码、处理多个附件、以及发送包含文本和HTML内容的邮件。更进一步，还讲解了如何将内存中的数据作为附件发送，以及如何嵌入内联图片到HTML邮件中。通过学习本文，你将全面掌握Java邮件发送附件的核心技术，让你的邮件功能更加强大和完善。

要实现Java邮件发送中附件的完整处理，核心在于巧妙运用JavaMail API中的MimeBodyPart和MimeMultipart。1. 首先设置邮件会话（Session），配置SMTP服务器信息；2. 创建MimeMessage对象并设置发件人、收件人和邮件主题；3. 创建MimeMultipart对象用于组合邮件的不同部分；4. 添加邮件正文内容，使用MimeBodyPart封装文本或HTML内容；5. 添加附件时创建MimeBodyPart并使用FileDataSource读取文件，通过DataHandler设置数据，并使用MimeUtility.encodeText对文件名进行编码以避免乱码；6. 将各部分添加到MimeMultipart中并通过message.setContent()方法将整个结构设置到邮件中；7. 对于多个附件，重复步骤5；8. 同时包含文本和HTML内容时，使用嵌套的MimeMultipart结构，外层为"mixed"类型，内层为"alternative"类型分别包含纯文本和HTML内容；9. 发送内存中的数据作为附件时可使用ByteArrayDataSource封装字节数组；10. 内联图片则需设置Content-ID和Disposition属性，并在HTML中通过cid引用该ID。这些步骤确保了邮件客户端能够正确解析和显示邮件内容及附件。

Java邮件发送中附件处理的完整实现教程

Java邮件发送中处理附件，核心在于巧妙运用JavaMail API中的MimeBodyPart和MimeMultipart。这套机制允许我们将邮件内容（文本、HTML）与各种附件（文件、图片、甚至内存数据）清晰地打包在一起，确保邮件客户端能正确解析和显示。理解MIME协议在这里至关重要，它就像是邮件内容的“说明书”，告诉接收方每个部分是什么类型、如何编码。

解决方案

要实现Java邮件发送中附件的完整处理，我们通常会遵循以下步骤，这其中涉及到的核心概念就是如何将邮件的各个组成部分（比如正文、附件）封装起来，然后整合成一封完整的邮件。

首先，你需要设置一个邮件会话（Session），这通常涉及到SMTP服务器的配置，比如主机、端口、认证信息等。这就像是告诉你的程序，你要通过哪个邮局来寄信。

import javax.mail.*;
import javax.mail.internet.*;
import javax.activation.*;
import java.io.File;
import java.util.Properties;

public class EmailSenderWithAttachment {

    public static void main(String[] args) {
        // 邮件服务器配置
        String host = "smtp.example.com"; // 替换为你的SMTP服务器
        String username = "your_email@example.com"; // 替换为你的邮箱地址
        String password = "your_email_password"; // 替换为你的邮箱密码
        int port = 587; // 或 465 (SSL)

        Properties props = new Properties();
        props.put("mail.smtp.auth", "true");
        props.put("mail.smtp.starttls.enable", "true"); // 对于587端口
        props.put("mail.smtp.host", host);
        props.put("mail.smtp.port", String.valueOf(port));
        // 如果是SSL，使用465端口，并添加以下配置
        // props.put("mail.smtp.socketFactory.port", "465");
        // props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");

        Session session = Session.getInstance(props, new Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(username, password);
            }
        });

        try {
            // 创建MimeMessage对象
            MimeMessage message = new MimeMessage(session);
            message.setFrom(new InternetAddress(username));
            message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com")); // 替换为收件人邮箱
            message.setSubject("JavaMail测试邮件 - 带附件");

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

            // 1. 添加邮件正文
            MimeBodyPart textPart = new MimeBodyPart();
            textPart.setText("这是一封来自JavaMail的测试邮件，请查收附件。", "UTF-8", "plain"); // 设置编码和内容类型
            multipart.addBodyPart(textPart);

            // 2. 添加附件
            String filePath = "/path/to/your/file.pdf"; // 替换为你的附件路径
            File attachmentFile = new File(filePath);
            if (attachmentFile.exists()) {
                MimeBodyPart attachmentPart = new MimeBodyPart();
                DataSource source = new FileDataSource(attachmentFile);
                attachmentPart.setDataHandler(new DataHandler(source));
                // 设置附件文件名，尤其注意中文文件名编码
                attachmentPart.setFileName(MimeUtility.encodeText(attachmentFile.getName(), "UTF-8", "B"));
                multipart.addBodyPart(attachmentPart);
            } else {
                System.out.println("附件文件不存在: " + filePath);
            }

            // 将MimeMultipart设置到MimeMessage中
            message.setContent(multipart);

            // 发送邮件
            Transport.send(message);
            System.out.println("邮件发送成功！");

        } catch (MessagingException | java.io.UnsupportedEncodingException e) {
            e.printStackTrace();
            System.out.println("邮件发送失败：" + e.getMessage());
        }
    }
}

这段代码展示了发送一封包含纯文本正文和一个附件的邮件。关键在于MimeMultipart的使用，它能够把MimeBodyPart对象（无论是文本还是附件）像积木一样拼起来。附件的setFileName方法尤其需要注意，特别是当文件名包含非ASCII字符时，使用MimeUtility.encodeText进行编码是避免乱码的关键。

为什么我的附件发送后文件名乱码或者打不开？

这确实是邮件发送中非常常见的一个“坑”，我个人觉得，很多时候并不是代码逻辑错了，而是对邮件协议细节理解不够深入。附件文件名乱码，几乎百分之九十是编码问题。邮件传输中，文件名需要按照MIME标准进行编码，特别是当文件名包含中文、日文等非ASCII字符时。如果你直接用attachmentPart.setFileName(attachmentFile.getName());，在某些邮件客户端上就很容易出现乱码。

解决方案很简单，但却容易被忽略：使用MimeUtility.encodeText()方法。这个方法会根据RFC 2047标准对字符串进行编码，确保文件名在邮件传输和接收时能被正确解析。例如：attachmentPart.setFileName(MimeUtility.encodeText(attachmentFile.getName(), "UTF-8", "B"));这里的"UTF-8"指定了原始文件名的编码，"B"表示使用Base64编码方式。

至于附件打不开，原因就比较多了。一个常见的问题是MIME类型不匹配。当你添加附件时，JavaMail会尝试根据文件扩展名自动推断MIME类型（比如.pdf是application/pdf，.jpg是image/jpeg）。但如果文件没有扩展名，或者扩展名不常见，自动推断可能就会出错。你可以通过DataSource的构造函数或者MimeBodyPart.setHeader("Content-Type", "your/mime-type")来显式设置MIME类型。

另外，文件本身损坏、文件路径不正确导致读取失败，或者邮件服务器对附件大小有限制，都可能导致附件无法打开。建议在发送前对附件文件进行简单的存在性检查和大小检查。

如何发送多个附件，或者同时包含文本内容和HTML内容？

发送多个附件其实和发送单个附件的思路是一致的，无非就是多创建几个MimeBodyPart，然后把它们都加到同一个MimeMultipart对象里。这就像在一个包裹里放多件物品，每个物品都是独立的，但都属于这个包裹。

// ... (之前的Session和MimeMessage设置)

MimeMultipart multipart = new MimeMultipart();

// 1. 添加邮件正文 (纯文本)
MimeBodyPart textPart = new MimeBodyPart();
textPart.setText("这是一封包含多个附件的邮件。", "UTF-8", "plain");
multipart.addBodyPart(textPart);

// 2. 添加第一个附件
String filePath1 = "/path/to/your/file1.pdf";
File attachmentFile1 = new File(filePath1);
if (attachmentFile1.exists()) {
    MimeBodyPart attachmentPart1 = new MimeBodyPart();
    DataSource source1 = new FileDataSource(attachmentFile1);
    attachmentPart1.setDataHandler(new DataHandler(source1));
    attachmentPart1.setFileName(MimeUtility.encodeText(attachmentFile1.getName(), "UTF-8", "B"));
    multipart.addBodyPart(attachmentPart1);
}

// 3. 添加第二个附件
String filePath2 = "/path/to/your/image.png";
File attachmentFile2 = new File(filePath2);
if (attachmentFile2.exists()) {
    MimeBodyPart attachmentPart2 = new MimeBodyPart();
    DataSource source2 = new FileDataSource(attachmentFile2);
    attachmentPart2.setDataHandler(new DataHandler(source2));
    attachmentPart2.setFileName(MimeUtility.encodeText(attachmentFile2.getName(), "UTF-8", "B"));
    multipart.addBodyPart(attachmentPart2);
}

message.setContent(multipart);
// ... (发送邮件)

而同时包含文本和HTML内容，这就要用到MimeMultipart的嵌套结构了，这其实是个挺有意思的设计。邮件客户端通常会优先显示HTML内容，如果客户端不支持HTML，就会回退显示纯文本内容。这种“优雅降级”的机制是通过multipart/alternativeMIME类型实现的。

// ... (Session和MimeMessage设置)

// 最外层的MimeMultipart，用于混合正文（文本/HTML）和附件
MimeMultipart mixedMultipart = new MimeMultipart("mixed");

// 创建一个MimeMultipart用于正文部分，类型为"alternative"
MimeMultipart bodyMultipart = new MimeMultipart("alternative");

// 1. 添加纯文本正文
MimeBodyPart plainTextPart = new MimeBodyPart();
plainTextPart.setText("这是邮件的纯文本内容，如果您的客户端不支持HTML，将会看到此内容。", "UTF-8", "plain");
bodyMultipart.addBodyPart(plainTextPart);

// 2. 添加HTML正文
MimeBodyPart htmlPart = new MimeBodyPart();
String htmlContent = "<h1>你好，世界！</h1><p>这是一封<b>HTML</b>格式的邮件内容。</p>";
htmlPart.setContent(htmlContent, "text/html; charset=UTF-8");
bodyMultipart.addBodyPart(htmlPart);

// 将正文的multipart添加到外层的mixedMultipart中
MimeBodyPart bodyContainer = new MimeBodyPart();
bodyContainer.setContent(bodyMultipart);
mixedMultipart.addBodyPart(bodyContainer);

// 3. 添加附件（和之前一样）
String filePath = "/path/to/your/document.docx";
File attachmentFile = new File(filePath);
if (attachmentFile.exists()) {
    MimeBodyPart attachmentPart = new MimeBodyPart();
    DataSource source = new FileDataSource(attachmentFile);
    attachmentPart.setDataHandler(new DataHandler(source));
    attachmentPart.setFileName(MimeUtility.encodeText(attachmentFile.getName(), "UTF-8", "B"));
    mixedMultipart.addBodyPart(attachmentPart);
}

message.setContent(mixedMultipart);
// ... (发送邮件)

这里，我们创建了一个mixedMultipart作为邮件的顶级容器，它包含了两个部分：一个是包裹了纯文本和HTML的bodyMultipart（类型是alternative），另一个就是附件。这种结构能够满足绝大多数复杂的邮件内容需求。

除了文件，我还能发送哪些类型的附件？内存中的数据如何作为附件发送？

JavaMail的DataSource接口设计得非常灵活，它不仅仅局限于文件。你可以将任何可以表示为数据流的东西作为附件发送。这包括但不限于：

内存中的字节数组 (byte array): 比如你从数据库中读取的图片二进制数据，或者程序动态生成的PDF报告内容。
输入流 (InputStream): 如果你的数据源是一个正在被读取的流，比如网络流、压缩包内的文件流。
内联图片 (Inline Images): 这种附件不是作为独立文件显示，而是嵌入在HTML邮件正文中，比如邮件签名里的公司Logo。

对于内存中的数据，我们主要会用到ByteArrayDataSource或自定义DataSource实现。

使用ByteArrayDataSource发送内存数据：

import javax.mail.util.ByteArrayDataSource; // 注意导入路径

// ... (Session和MimeMessage设置)

MimeMultipart multipart = new MimeMultipart();

// 1. 添加邮件正文
MimeBodyPart textPart = new MimeBodyPart();
textPart.setText("这是一封包含内存数据作为附件的邮件。", "UTF-8", "plain");
multipart.addBodyPart(textPart);

// 2. 将字符串内容作为附件发送
String contentToAttach = "这是我从内存中生成的文本内容，可以作为txt文件发送。";
byte[] contentBytes = contentToAttach.getBytes("UTF-8");

MimeBodyPart memoryAttachmentPart = new MimeBodyPart();
// 注意这里的MIME类型，如果是文本就用text/plain
DataSource memorySource = new ByteArrayDataSource(contentBytes, "text/plain");
memoryAttachmentPart.setDataHandler(new DataHandler(memorySource));
memoryAttachmentPart.setFileName(MimeUtility.encodeText("内存文本.txt", "UTF-8", "B"));
multipart.addBodyPart(memoryAttachmentPart);

message.setContent(multipart);
// ... (发送邮件)

ByteArrayDataSource非常方便，你只需要提供字节数组和对应的MIME类型即可。

发送内联图片 (嵌入HTML正文的图片)：

内联图片的核心在于设置Content-ID和Disposition。邮件客户端会根据Content-ID在HTML内容中查找并显示图片，而不是将其作为独立附件列出。

// ... (Session和MimeMessage设置)

// 最外层MimeMultipart，类型为"related"，因为它包含HTML和相关的内联资源
MimeMultipart relatedMultipart = new MimeMultipart("related");

// HTML正文部分
MimeBodyPart htmlPart = new MimeBodyPart();
String htmlContent = "<html><body><h1>欢迎！</h1><p>这是我们的Logo：<img src='cid:companyLogo'></p></body></html>";
htmlPart.setContent(htmlContent, "text/html; charset=UTF-8");
relatedMultipart.addBodyPart(htmlPart);

// 内联图片附件
String imagePath = "/path/to/your/logo.png"; // 替换为你的图片路径
File imageFile = new File(imagePath);
if (imageFile.exists()) {
    MimeBodyPart imagePart = new MimeBodyPart();
    DataSource imageSource = new FileDataSource(imageFile);
    imagePart.setDataHandler(new DataHandler(imageSource));
    imagePart.setHeader("Content-ID", "<companyLogo>"); // 必须有<>
    imagePart.setDisposition(MimeBodyPart.INLINE); // 设置为内联
    // 文件名可以设置，但通常内联图片不显示文件名
    imagePart.setFileName(MimeUtility.encodeText(imageFile.getName(), "UTF-8", "B"));
    relatedMultipart.addBodyPart(imagePart);
}

message.setContent(relatedMultipart);
// ... (发送邮件)

这里需要注意的是，外层的MimeMultipart类型变为了"related"，这表明其中的内容是相互关联的（HTML和它引用的图片）。HTML中的src='cid:companyLogo'就是通过Content-ID来引用内联图片的。这种方式让你的HTML邮件看起来更专业，避免了图片以独立附件形式出现。

总的来说，JavaMail API在附件处理上提供了极大的灵活性，只要你理解MIME协议的基本原理和MimeBodyPart、MimeMultipart的组合使用方式，几乎任何类型的附件需求都能得到满足。

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