要实现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邮件发送中处理附件，核心在于巧妙运用JavaMail API中的MimeBodyPart和MimeMultipart。这套机制允许我们将邮件内容（文本、HTML）与各种附件（文件、图片、甚至内存数据）清晰地打包在一起，确保邮件客户端能正确解析和显示。理解MIME协议在这里至关重要，它就像是邮件内容的“说明书”，告诉接收方每个部分是什么类型、如何编码。
解决方案
要实现Java邮件发送中附件的完整处理，我们通常会遵循以下步骤，这其中涉及到的核心概念就是如何将邮件的各个组成部分（比如正文、附件）封装起来，然后整合成一封完整的邮件。
首先，你需要设置一个邮件会话（Session），这通常涉及到SMTP服务器的配置，比如主机、端口、认证信息等。这就像是告诉你的程序，你要通过哪个邮局来寄信。
立即学习“Java免费学习笔记（深入）”；
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：@@##@@</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的组合使用方式，几乎任何类型的附件需求都能得到满足。
