要实现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类型实现的。
专为中小型企业定制的网络办公软件,富有竞争力的十大特性： 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装，建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件，使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件，提供web方式的远程邮件服务。 4、集成语音会议组件，节省长途话费开支。 5、集成手机短信组件，重要信息可直接发送到员工手机。 6、集成网络硬
// ... (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 = "你好，世界！
这是一封HTML格式的邮件内容。
";
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 = "欢迎！
这是我们的Logo：@@##@@
";
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", ""); // 必须有<>
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的组合使用方式，几乎任何类型的附件需求都能得到满足。
