Java邮件发送终极指南：SMTP协议、附件处理与实战技巧

在当今互联网时代，电子邮件仍然是企业沟通和系统通知的重要渠道。作为Java开发者，掌握邮件发送技术是必备技能之一。本文将全面讲解Java邮件发送的各个方面，从基础概念到高级应用，带你深入理解JavaMail API的实现原理和最佳实践。

一、Java邮件发送基础

Java邮件发送主要依赖JavaMail API，这是Oracle官方提供的标准扩展库。要使用JavaMail，首先需要了解几个核心概念：

1. SMTP协议：简单邮件传输协议，负责发送邮件
2. POP3/IMAP协议：用于接收邮件的协议
3. MIME协议：多媒体邮件扩展，支持附件和HTML内容

基本依赖配置（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>

二、基础邮件发送实现

以下是使用JavaMail发送简单文本邮件的完整示例代码：

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

public class SimpleEmailSender {
    public static void sendEmail(String host, String port, 
                               final String userName, final String password,
                               String toAddress, String subject, String message) 
                               throws AddressException, MessagingException {

        // 设置邮件服务器属性
        Properties properties = new Properties();
        properties.put("mail.smtp.host", host);
        properties.put("mail.smtp.port", port);
        properties.put("mail.smtp.auth", "true");
        properties.put("mail.smtp.starttls.enable", "true");

        // 创建认证器
        Authenticator auth = new Authenticator() {
            public PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(userName, password);
            }
        };

        // 创建会话
        Session session = Session.getInstance(properties, auth);

        // 创建邮件
        Message msg = new MimeMessage(session);
        msg.setFrom(new InternetAddress(userName));
        InternetAddress[] toAddresses = { new InternetAddress(toAddress) };
        msg.setRecipients(Message.RecipientType.TO, toAddresses);
        msg.setSubject(subject);
        msg.setText(message);

        // 发送邮件
        Transport.send(msg);
    }
}

三、高级邮件功能实现

1. 发送HTML格式邮件

// 替换普通文本邮件中的setText方法
MimeBodyPart htmlPart = new MimeBodyPart();
htmlPart.setContent("<h1>这是HTML内容</h1><p>带格式的邮件正文</p>", "text/html");

Multipart multipart = new MimeMultipart();
multipart.addBodyPart(htmlPart);
msg.setContent(multipart);

2. 添加附件

// 创建消息部分
MimeBodyPart messageBodyPart = new MimeBodyPart();
messageBodyPart.setText("这是带附件的邮件");

// 创建多部分消息
Multipart multipart = new MimeMultipart();
multipart.addBodyPart(messageBodyPart);

// 添加附件
messageBodyPart = new MimeBodyPart();
String filename = "附件.pdf";
DataSource source = new FileDataSource(filename);
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName(filename);
multipart.addBodyPart(messageBodyPart);

// 设置完整消息
msg.setContent(multipart);

3. 发送带内嵌图片的HTML邮件

// 创建HTML内容
String htmlText = "<H1>Hello</H1><img src=\"cid:memememe\">";
MimeBodyPart htmlPart = new MimeBodyPart();
htmlPart.setContent(htmlText, "text/html");

// 创建图片部分
MimeBodyPart imagePart = new MimeBodyPart();
imagePart.setHeader("Content-ID", "<memememe>");
imagePart.setDisposition(MimeBodyPart.INLINE);
imagePart.attachFile("/path/to/image.jpg");

// 组合内容
MimeMultipart multipart = new MimeMultipart();
multipart.addBodyPart(htmlPart);
multipart.addBodyPart(imagePart);

msg.setContent(multipart);

四、企业级应用实践

1. 邮件发送队列实现

在高并发场景下，直接发送邮件可能导致性能问题。建议实现邮件队列：

// 使用BlockingQueue实现简单邮件队列
BlockingQueue<EmailTask> emailQueue = new LinkedBlockingQueue<>();

// 消费者线程
new Thread(() -> {
    while (true) {
        try {
            EmailTask task = emailQueue.take();
            sendEmail(task);
        } catch (Exception e) {
            // 错误处理
        }
    }
}).start();

// 生产者只需将邮件任务放入队列
emailQueue.put(new EmailTask(to, subject, content));

2. 邮件模板引擎集成

推荐使用Thymeleaf或FreeMarker作为邮件模板引擎：

// Thymeleaf示例
Context context = new Context();
context.setVariable("name", "张三");
String htmlContent = templateEngine.process("email-template", context);

MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setTo("[email protected]");
helper.setSubject("模板邮件");
helper.setText(htmlContent, true);

mailSender.send(message);

五、常见问题与解决方案

1. 连接超时问题：

2. 增加超时设置：
   properties mail.smtp.connectiontimeout=5000 mail.smtp.timeout=5000 mail.smtp.writetimeout=5000

3. 认证失败：

4. 检查用户名密码是否正确

5. 某些邮箱需要应用专用密码

6. 被识别为垃圾邮件：

7. 配置SPF、DKIM记录
8. 避免使用垃圾邮件常用关键词

9. 添加退订链接

10. 性能优化：

    

11. 使用连接池：
    java properties.put("mail.smtp.connectionpool", "true"); properties.put("mail.smtp.connectionpoolsize", "10");

六、Spring集成方案

Spring框架提供了更简洁的邮件发送方式：

@Configuration
public class MailConfig {
    @Bean
    public JavaMailSender javaMailSender() {
        JavaMailSenderImpl mailSender = new JavaMailSenderImpl();
        mailSender.setHost("smtp.example.com");
        mailSender.setPort(587);
        mailSender.setUsername("username");
        mailSender.setPassword("password");

        Properties props = mailSender.getJavaMailProperties();
        props.put("mail.transport.protocol", "smtp");
        props.put("mail.smtp.auth", "true");
        props.put("mail.smtp.starttls.enable", "true");

        return mailSender;
    }
}

@Service
public class EmailService {
    @Autowired
    private JavaMailSender mailSender;

    public void sendEmail(String to, String subject, String text) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setTo(to);
        message.setSubject(subject);
        message.setText(text);
        mailSender.send(message);
    }
}