JavaMail邮件发送实战：从基础配置到高级应用
1. JavaMail邮件发送的核心价值与应用场景
在当今企业级应用开发中，邮件通知系统几乎成为标配功能。用户注册验证码、订单状态变更、系统告警通知等场景都离不开邮件发送能力。JavaMail作为JavaEE规范的一部分，提供了与协议无关的邮件收发API，让我们能够用统一的方式操作SMTP、POP3等不同协议。
我经历过多个需要邮件通知的项目，从最初使用Spring Boot的starter，到后来需要深度定制邮件功能时直接使用JavaMail API，积累了不少实战经验。相比第三方封装库，原生JavaMail虽然使用稍显复杂，但胜在可控性强，能够处理各种特殊场景（比如需要连接内网邮件服务器时）。
2. 环境准备与基础配置
2.1 必备组件清单
要使用JavaMail发送邮件，需要准备以下组件：
- JavaMail API（javax.mail包）
- Java Activation Framework（处理附件时需要）
- 有效的SMTP服务器配置（企业邮箱或公共邮箱服务）
对于Maven项目，在pom.xml中添加：
<dependency> <groupId>com.sun.mail</groupId> <artifactId>javax.mail</artifactId> <version>1.6.2</version> </dependency> <dependency> <groupId>javax.activation</groupId> <artifactId>activation</artifactId> <version>1.1.1</version> </dependency>2.2 SMTP服务器配置详解
不同邮件服务商的SMTP配置差异较大，这里以常见配置为例：
| 服务商 | SMTP服务器 | 端口 | SSL要求 |
|---|---|---|---|
| 网易163 | smtp.163.com | 465/994 | 必须 |
| QQ邮箱 | smtp.qq.com | 465/587 | 必须 |
| Gmail | smtp.gmail.com | 465 | 必须 |
| 企业自建 | 自定义地址 | 通常25 | 可选 |
重要提示：使用公共邮箱服务时，需要先在邮箱设置中开启SMTP服务并获取授权码（非登录密码）
3. 核心代码实现与原理剖析
3.1 建立邮件会话(Session)
Session是JavaMail的核心概念，包含与邮件服务器通信所需的全部配置：
Properties props = new Properties(); props.put("mail.smtp.host", "smtp.163.com"); props.put("mail.smtp.port", "465"); props.put("mail.smtp.auth", "true"); props.put("mail.smtp.ssl.enable", "true"); Session session = Session.getInstance(props, new Authenticator() { protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication("username@163.com", "授权码"); } });关键参数说明：
mail.smtp.timeout：连接超时时间（毫秒）mail.smtp.connectiontimeout：建立连接超时mail.smtp.writetimeout：写操作超时mail.debug：设置为true可输出详细协议交互日志
3.2 构建邮件内容(Message)
MimeMessage是最常用的邮件类型，支持HTML内容和附件：
MimeMessage message = new MimeMessage(session); // 设置发件人（必须与认证用户一致） message.setFrom(new InternetAddress("sender@163.com")); // 设置收件人 message.setRecipient(Message.RecipientType.TO, new InternetAddress("receiver@example.com")); // 设置主题 message.setSubject("测试邮件主题"); // 设置正文（支持HTML） message.setContent("<h1>HTML内容</h1>", "text/html;charset=UTF-8"); // 添加抄送 message.addRecipient(Message.RecipientType.CC, new InternetAddress("cc@example.com"));3.3 发送邮件
发送操作看似简单，但需要注意异常处理：
try { Transport.send(message); System.out.println("邮件发送成功"); } catch (MessagingException e) { // 特别注意：这里可能抛出多种异常 if (e instanceof SendFailedException) { Address[] invalid = ((SendFailedException)e).getInvalidAddresses(); // 处理无效地址 } throw new RuntimeException("邮件发送失败", e); }4. 高级功能实现
4.1 带附件的邮件
需要使用MimeMultipart构建多部分内容：
// 创建消息容器 MimeMultipart multipart = new MimeMultipart(); // 添加文本部分 MimeBodyPart textPart = new MimeBodyPart(); textPart.setContent("邮件正文内容", "text/plain;charset=UTF-8"); multipart.addBodyPart(textPart); // 添加附件 MimeBodyPart attachPart = new MimeBodyPart(); attachPart.attachFile(new File("/path/to/file.pdf")); attachPart.setFileName(MimeUtility.encodeText("中文文件名.pdf")); multipart.addBodyPart(attachPart); // 设置邮件内容 message.setContent(multipart);4.2 内嵌图片的HTML邮件
String html = "<html><body><img src='cid:image1'></body></html>"; MimeMultipart multipart = new MimeMultipart("related"); // HTML部分 MimeBodyPart htmlPart = new MimeBodyPart(); htmlPart.setContent(html, "text/html;charset=UTF-8"); multipart.addBodyPart(htmlPart); // 图片部分 MimeBodyPart imagePart = new MimeBodyPart(); imagePart.attachFile(new File("/path/to/image.png")); imagePart.setContentID("<image1>"); imagePart.setDisposition(MimeBodyPart.INLINE); multipart.addBodyPart(imagePart); message.setContent(multipart);5. 生产环境实践要点
5.1 性能优化建议
- 使用连接池：JavaMail本身不支持连接池，可以通过第三方库如simple-java-mail
- 异步发送：避免阻塞主线程，推荐使用线程池
- 批量发送：合并多个收件人到一个请求中
// 批量添加收件人 Address[] addresses = InternetAddress.parse("a@x.com,b@x.com"); message.addRecipients(Message.RecipientType.TO, addresses);5.2 常见问题排查
认证失败(535 Error)
- 检查是否使用授权码而非登录密码
- 确认SMTP服务已开启
- 检查用户名是否完整（需要带@domain.com）
连接超时
- 检查网络是否可达邮件服务器
- 尝试更换端口（如465换成587）
- 检查防火墙设置
中文乱码
- 确保所有字符串设置charset
- 对文件名使用MimeUtility.encodeText编码
被识别为垃圾邮件
- 添加DKIM/DMARC记录
- 避免使用敏感词汇
- 设置合理的发送频率
5.3 安全性建议
- 不要硬编码密码：使用配置中心或环境变量
- 启用TLS加密：设置
mail.smtp.starttls.enable=true - 限制发送频率：避免被识别为垃圾邮件发送者
- 验证收件人地址：防止无效地址累积
6. 完整示例代码
以下是一个生产可用的工具类示例：
public class EmailSender { private final Session session; public EmailSender(String host, int port, String username, String password, boolean ssl) { Properties props = new Properties(); props.put("mail.smtp.host", host); props.put("mail.smtp.port", port); props.put("mail.smtp.auth", "true"); props.put("mail.smtp.ssl.enable", String.valueOf(ssl)); props.put("mail.smtp.timeout", "10000"); this.session = Session.getInstance(props, new Authenticator() { protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(username, password); } }); } public void sendEmail(String from, String to, String subject, String content, List<File> attachments) throws Exception { MimeMessage message = new MimeMessage(session); message.setFrom(new InternetAddress(from)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); message.setSubject(subject); if (attachments == null || attachments.isEmpty()) { message.setContent(content, "text/html;charset=UTF-8"); } else { MimeMultipart multipart = new MimeMultipart(); MimeBodyPart textPart = new MimeBodyPart(); textPart.setContent(content, "text/html;charset=UTF-8"); multipart.addBodyPart(textPart); for (File file : attachments) { MimeBodyPart attachPart = new MimeBodyPart(); attachPart.attachFile(file); attachPart.setFileName( MimeUtility.encodeText(file.getName())); multipart.addBodyPart(attachPart); } message.setContent(multipart); } Transport.send(message); } }在实际项目中，我会将这个工具类进一步扩展，加入重试机制、异步发送、结果回调等功能。邮件发送看似简单，但要保证高可靠性和高性能，还是有很多细节需要打磨。比如遇到网络波动时自动重试，对大批量收件人进行分批发送，以及实现发送结果的持久化记录等。