Java发送邮件附件的实现方法和注意事项在Java开发中，发送带有附件的邮件是一个常见的需求，无论是系统通知、报表发送还是文件传输都需要这项功能。我们这篇文章将全面讲解如何使用JavaMail API实现邮件附件发送，包括环境配置、代码实

Java发送邮件附件的实现方法和注意事项

在Java开发中，发送带有附件的邮件是一个常见的需求，无论是系统通知、报表发送还是文件传输都需要这项功能。我们这篇文章将全面讲解如何使用JavaMail API实现邮件附件发送，包括环境配置、代码实现、常见问题及优化建议。主要内容包括：JavaMail环境准备；核心API介绍；发送附件的完整示例；常见邮件协议对比；安全注意事项；性能优化建议；7. 常见问题解答。

一、JavaMail环境准备

要实现邮件发送功能，在一开始需要配置JavaMail环境。JavaMail不是JDK的标准组件，需要单独引入依赖：

// Maven依赖
<dependency>
    <groupId>javax.mail</groupId>
    <artifactId>javax.mail-api</artifactId>
    <version>1.6.2</version>
</dependency>
<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

同时需要确保使用的邮件服务器支持SMTP协议（如QQ邮箱、163邮箱或企业自建邮件服务器），并提前获取以下信息：SMTP服务器地址、端口号（通常25或465）、账号授权码（非登录密码）。

二、核心API介绍

JavaMail API中几个关键类和接口：

• Session：邮件会话，保存SMTP服务器配置信息
• MimeMessage：表示一封MIME格式的邮件
• MimeMultipart：存放多个邮件内容部分（文本+附件）
• MimeBodyPart：邮件的具体内容部分
• Transport：发送邮件的传输通道

发送附件时需要创建multipart/mixed类型的MimeMultipart对象，分别添加文本内容和附件内容。

三、发送附件的完整示例

以下是发送带附件邮件的完整代码示例（以QQ邮箱为例）：

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

public class MailWithAttachment {
    public static void main(String[] args) throws Exception {
        // 1. 配置参数
        Properties props = new Properties();
        props.put("mail.smtp.host", "smtp.qq.com"); 
        props.put("mail.smtp.port", "587");
        props.put("mail.smtp.auth", "true");
        props.put("mail.smtp.starttls.enable", "true");
        
        // 2. 创建Session（替换实际账号和授权码）
        Session session = Session.getInstance(props, 
            new Authenticator() {
                protected PasswordAuthentication getPasswordAuthentication() {
                    return new PasswordAuthentication(
                        "your_email@qq.com", 
                        "your_authorization_code");
                }
            });
        
        // 3. 创建邮件
        Message message = new MimeMessage(session);
        message.setFrom(new InternetAddress("your_email@qq.com"));
        message.setRecipients(Message.RecipientType.TO, 
            InternetAddress.parse("recipient@example.com"));
        message.setSubject("测试带附件邮件");
        
        // 4. 创建多部分内容（文本+附件）
        Multipart multipart = new MimeMultipart();
        
        // 添加文本内容
        BodyPart textPart = new MimeBodyPart();
        textPart.setText("这是邮件正文内容，请查收附件");
        multipart.addBodyPart(textPart);
        
        // 添加附件（替换实际文件路径）
        BodyPart filePart = new MimeBodyPart();
        String filename = "C:/test/document.pdf";
        filePart.setDataHandler(new DataHandler(
            new FileDataSource(filename)));
        filePart.setFileName(new File(filename).getName());
        multipart.addBodyPart(filePart);
        
        // 设置邮件内容
        message.setContent(multipart);
        
        // 5. 发送邮件
        Transport.send(message);
        System.out.println("邮件发送成功");
    }
}

四、常见邮件协议对比

协议	端口	加密方式	适用场景
SMTP	25/587	STARTTLS	标准邮件发送
SMTPS	465	SSL/TLS	安全要求高的场景
IMAP	143/993	STARTTLS/SSL	邮件接收

实际开发中建议优先使用SMTPS（465端口）保障传输安全，特别是发送敏感文件时。

五、安全注意事项

1. 避免硬编码凭证：应将账号密码存储在配置文件中或使用环境变量
2. 附件大小限制：多数邮件服务器限制单个附件不超过25MB
3. 文件类型检查：应验证附件类型，避免传播恶意文件
4. 连接超时设置：建议设置connectTimeout和timeout（默认无超时）

六、性能优化建议

• 复用Session：频繁发送邮件时应复用Session对象
• 异步发送：大量邮件发送建议使用线程池异步处理
• 压缩大附件：超过5MB的附件建议先压缩再发送
• 使用连接池：考虑采用commons-email等封装库管理连接

七、常见问题解答Q&A

发送邮件时报535错误怎么办？

535错误通常表示认证失败，请检查：1) 是否使用了授权码而非登录密码（QQ/163邮箱必须）；2) SMTP服务是否已开启；3) 账号是否被限制。

如何发送多个附件？

创建多个MimeBodyPart对象，每个对应一个附件，全部添加到Multipart中即可。示例：

for (File file : attachments) {
    MimeBodyPart attachmentPart = new MimeBodyPart();
    attachmentPart.attachFile(file);
    multipart.addBodyPart(attachmentPart);
}

内嵌图片和附件有什么区别？

内嵌图片（CID引用）会显示在邮件正文中，使用multipart/related类型；附件则独立显示在邮件底部，使用multipart/mixed类型。