要使用java发送邮件，核心是利用javamail api，步骤如下：1. 引入javamail依赖，如在maven项目中添加对应dependency；2. 配置smtp服务器信息，包括host、port、认证方式等；3. 创建session对象，用于与邮件服务器建立会话；4. 构建mimemessage对象，设置发件人、收件人、主题和内容；5. 使用transport类发送邮件。若需发送html内容或附件，需使用mimemultipart和mimebodypart组合邮件内容。常见问题如认证失败、连接超时、ssl/tls握手失败等，需检查用户名密码、网络配置及证书设置。在spring boot项目中，可通过引入spring-boot-starter-mail模块并配置邮件属性，结合javamailsender和mimemessagehelper简化邮件发送流程，实现更优雅的集成。
用Java发送邮件，核心在于利用JavaMail API，它提供了一套标准接口来处理邮件的发送、接收和管理。你只需要配置好SMTP服务器信息，构建邮件内容，然后通过Transport类就能轻松发送出去。这听起来可能有点技术性，但实际操作起来，步骤是相当清晰的。
解决方案
其实，用Java发邮件这事儿，核心就是那么几步，它依赖于JavaMail API。首先，你得把JavaMail的库引入到你的项目里，如果你用Maven，那就在pom.xml里加：
com.sun.mail jakarta.mail 2.0.1 jakarta.activation jakarta.activation-api 2.0.1
接着，就是编写发送邮件的代码了。我个人觉得，最关键的是理解邮件会话（Session）和邮件内容（MimeMessage）这两个概念。
立即学习“Java免费学习笔记（深入）”；
import jakarta.mail.*;
import jakarta.mail.internet.*;
import java.util.Properties;
public class EmailSender {
public static void main(String[] args) {
// 1. 配置邮件服务器属性
// 这一步就像告诉你的程序，你要通过哪个邮局（SMTP服务器）寄信
Properties props = new Properties();
props.put("mail.smtp.host", "smtp.example.com"); // 替换为你的SMTP服务器地址，例如smtp.qq.com, smtp.gmail.com
props.put("mail.smtp.port", "587"); // SMTP端口，通常是25, 465(SSL), 587(TLS)
props.put("mail.smtp.auth", "true"); // 需要认证
props.put("mail.smtp.starttls.enable", "true"); // 启用TLS加密
// 如果是SSL/TLS端口，比如Gmail的465，可能需要这样配置
// props.put("mail.smtp.socketFactory.port", "465");
// props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
// props.put("mail.smtp.ssl.enable", "true"); // 启用SSL
// 2. 创建Session对象
// Session就像你和邮局之间建立的一个会话，通过它来处理所有的邮件操作
Session session = Session.getInstance(props, new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
// 替换为你的邮箱地址和授权码（或密码）
// 很多邮箱服务为了安全，需要使用授权码而非登录密码
return new PasswordAuthentication("your_email@example.com", "your_authorization_code");
}
});
// 开启调试模式，可以看到更详细的发送过程日志，排查问题很有用
// session.setDebug(true);
try {
// 3. 创建MimeMessage对象
// 这就是你要发送的那封信了，可以设置发件人、收件人、主题、内容等等
MimeMessage message = new MimeMessage(session);
// 设置发件人
message.setFrom(new InternetAddress("your_email@example.com"));
// 设置收件人
// To: 主要收件人
message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient_email@example.com"));
// Cc: 抄送
// message.setRecipients(Message.RecipientType.CC, InternetAddress.parse("cc_email@example.com"));
// Bcc: 密送
// message.setRecipients(Message.RecipientType.BCC, InternetAddress.parse("bcc_email@example.com"));
// 设置邮件主题
message.setSubject("Java发送邮件测试 - " + System.currentTimeMillis());
// 设置邮件内容
// 默认是纯文本
message.setText("你好，这是一封通过Java程序发送的测试邮件。希望你能收到！");
// 4. 发送邮件
// Transport就是那个帮你把信寄出去的“邮递员”
Transport.send(message);
System.out.println("邮件发送成功！");
} catch (MessagingException e) {
// 捕获发送过程中可能出现的异常
System.err.println("邮件发送失败：" + e.getMessage());
e.printStackTrace();
}
}
}这段代码，基本上涵盖了邮件发送的骨架。你需要做的就是替换那些占位符，比如SMTP服务器地址、端口、你的邮箱和授权码，以及收件人地址。我特别强调一下“授权码”这东西，现在很多邮箱服务，比如QQ邮箱、Gmail等，出于安全考虑，不再允许直接使用登录密码进行SMTP认证，而是需要你生成一个“授权码”或“应用专用密码”。这个在你的邮箱设置里通常能找到。
JavaMail API发送邮件时如何处理附件和HTML内容？
发送纯文本邮件固然简单，但在实际应用中，我们经常需要发送带有格式的HTML邮件，或者附带文件。JavaMail API当然考虑到了这一点，它通过MimeMultipart和MimeBodyPart来优雅地处理这些复杂场景。这就像你要寄一封信，信里不仅有文字，还想塞一张照片进去，或者信纸本身就是彩色的、有排版的。
要发送HTML内容，你只需要在设置邮件内容时，指定其MIME类型为text/html：
// ... (前面的Session和MimeMessage创建保持不变) ... // 设置HTML邮件内容 String htmlContent = "你好！
" + "这是一封HTML格式的测试邮件，通过Java发送。
" + "希望你能看到漂亮的排版和加粗的文字！
" + "@@##@@"; // 也可以包含图片链接 message.setContent(htmlContent, "text/html; charset=utf-8"); // 明确指定内容类型和字符编码 // ... (后续的Transport.send(message)保持不变) ...
至于附件，那就稍微复杂一点点，但逻辑也很直观。你需要创建一个MimeMultipart对象作为邮件的“主体”，然后把文本内容和附件都作为MimeBodyPart添加到这个主体里。
import jakarta.activation.DataHandler;
import jakarta.activation.DataSource;
import jakarta.activation.FileDataSource;
// ... 其他导入 ...
// ... (前面的Session和MimeMessage创建保持不变) ...
try {
MimeMessage message = new MimeMessage(session);
// ... 设置发件人、收件人、主题 ...
// 创建一个MimeMultipart对象，用于组合邮件的不同部分（文本、附件）
Multipart multipart = new MimeMultipart();
// 1. 添加邮件正文（可以是纯文本或HTML）
BodyPart messageBodyPart = new MimeBodyPart();
String htmlContent = "你好！
"
+ "这是一封带有附件的测试邮件，通过Java发送。
"
+ "请查收附件。
";
messageBodyPart.setContent(htmlContent, "text/html; charset=utf-8");
multipart.addBodyPart(messageBodyPart);
// 2. 添加附件
messageBodyPart = new MimeBodyPart();
String filename = "/path/to/your/file.pdf"; // 替换为你要发送的文件路径
DataSource source = new FileDataSource(filename);
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName(source.getName()); // 设置附件的文件名
multipart.addBodyPart(messageBodyPart);
// 如果想添加多个附件，重复上述“添加附件”的步骤即可
// 将MimeMultipart对象设置为邮件的内容
message.setContent(multipart);
// 4. 发送邮件
Transport.send(message);
System.out.println("带附件和HTML内容的邮件发送成功！");
} catch (MessagingException e) {
System.err.println("邮件发送失败：" + e.getMessage());
e.printStackTrace();
}这里有个小细节，FileDataSource是用于从文件系统读取数据源的，如果你想从其他地方（比如内存中的字节数组）作为附件，可以考虑实现自己的DataSource。我个人觉得，这种分层组合的方式，虽然代码量多了一点，但逻辑上非常清晰，便于管理邮件的复杂结构。
JavaMail API发送邮件时常见的错误和解决方案有哪些？
在用JavaMail API发送邮件的过程中，我遇到过不少“坑”。这些问题往往不是代码逻辑上的错误，而是配置、网络或者邮件服务商策略导致的。理解这些常见问题及其解决方案，能让你在遇到困难时少走很多弯路。
-
认证失败 (Authentication Failed):
-
问题描述: 收到
AuthenticationFailedException，通常提示用户名或密码错误。 -
解决方案:
- 检查用户名和密码/授权码: 确保你提供的邮箱地址和授权码（或密码）是正确的。很多邮箱服务（如Gmail、QQ邮箱、163邮箱）为了安全，需要你开启SMTP服务并生成一个“授权码”或“应用专用密码”来代替登录密码。
- 检查SMTP服务器是否开启: 确保你的邮箱服务商已经允许SMTP客户端发送邮件。
- 网络连接: 确认你的服务器或本地机器可以访问邮件服务商的SMTP服务器。
-
问题描述: 收到
-
连接超时或无法连接 (Connection Timeout/Could not connect to SMTP host):
-
问题描述: 出现
ConnectException或SocketTimeoutException，提示无法连接到SMTP主机或连接超时。 -
解决方案:
-
检查SMTP主机地址和端口: 确保
mail.smtp.host和mail.smtp.port配置正确。例如，Gmail的SMTP是smtp.gmail.com，端口通常是587（TLS）或465（SSL）。 - 防火墙问题: 检查你的服务器或本地机器的防火墙是否阻止了对SMTP端口的传出连接。
-
网络问题: 确认网络连接稳定，DNS解析正常。可以尝试
ping smtp.example.com或telnet smtp.example.com 587来测试连通性。
-
检查SMTP主机地址和端口: 确保
-
问题描述: 出现
-
SSL/TLS握手失败 (SSL/TLS Handshake Failure):
-
问题描述: 出现与SSL/TLS相关的错误，例如
PKIX path building failed或Could not convert socket to TLS。 -
解决方案:
-
SSL/TLS配置: 确保
mail.smtp.starttls.enable设置为true(对于587端口) 或mail.smtp.ssl.enable设置为true(对于465端口)。 -
证书问题: 有时是Java环境的CA证书库缺少了SMTP服务器的证书。这在生产环境中较少见，但在某些自签名证书或企业内部邮件服务器上可能发生。确保Java的
cacerts文件是最新的，或者手动导入证书。 - Java版本: 确保你的Java版本支持所需的TLS协议版本。
-
SSL/TLS配置: 确保
-
问题描述: 出现与SSL/TLS相关的错误，例如
-
邮件地址格式不正确 (Invalid Address):
-
问题描述: 出现
AddressException，提示邮件地址格式不合法。 -
解决方案:
-
检查邮件地址: 确保所有发件人、收件人、抄送、密送地址都符合标准的邮件格式，例如
user@domain.com。
-
检查邮件地址: 确保所有发件人、收件人、抄送、密送地址都符合标准的邮件格式，例如
-
问题描述: 出现
-
字符编码问题 (Garbled Characters):
- 问题描述: 邮件内容在收件人端显示乱码。
-
解决方案:
-
明确指定编码: 在设置邮件内容时，务必指定字符编码，例如
message.setText(content, "utf-8")或message.setContent(htmlContent, "text/html; charset=utf-8")。统一使用UTF-8是一个好习惯。
-
明确指定编码: 在设置邮件内容时，务必指定字符编码，例如
调试小技巧: 我个人强烈推荐在开发阶段开启JavaMail的调试模式，这能让你看到非常详细的SMTP会话日志，包括客户端和服务端之间的每一条命令和响应。这对于诊断连接、认证或传输问题非常有帮助。
session.setDebug(true); // 在创建Session后添加这行
通过观察这些日志，你通常能快速定位问题所在。比如，看到535 Authentication Failed就明确是认证问题，看到220 Service ready但后面没动静，可能就是防火墙或连接阻塞了。
在Spring Boot项目中如何更优雅地集成Java邮件发送功能？
如果你正在使用Spring Boot，那么恭喜你，发送邮件这事儿会变得异常简单和优雅。Spring Boot提供了一个spring-boot-starter-mail模块，它自动配置了JavaMailSender，让你几乎不用关心JavaMail API的底层细节。我个人觉得，这是Spring Boot最让人省心的地方之一。
首先，在你的pom.xml里引入这个Starter：
org.springframework.boot spring-boot-starter-mail
接着，在application.properties或application.yml中配置邮件服务器信息。这些配置项Spring Boot会自动识别并用来创建JavaMailSender实例：
# application.properties spring.mail.host=smtp.example.com spring.mail.port=587 spring.mail.username=your_email@example.com spring.mail.password=your_authorization_code spring.mail.properties.mail.smtp.auth=true spring.mail.properties.mail.smtp.starttls.enable=true spring.mail.properties.mail.smtp.starttls.required=true # 有些服务器需要 # spring.mail.properties.mail.smtp.ssl.enable=true # 如果使用SSL，如465端口
然后，你就可以在你的服务类中直接注入JavaMailSender，并使用它来发送邮件了。Spring提供了一个MimeMessageHelper，它比直接操作MimeMessage要方便得多，尤其是在处理HTML内容和附件时。
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
import jakarta.mail.MessagingException;
import jakarta.mail.internet.MimeMessage;
import java.io.File;
import java.nio.charset.StandardCharsets;
@Service
public class EmailService {
private final JavaMailSender mailSender;
// Spring会自动注入JavaMailSender
public EmailService(JavaMailSender mailSender) {
this.mailSender = mailSender;
}
public void sendSimpleEmail(String to, String subject, String content) {
try {
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true, StandardCharsets.UTF_8.name()); // true表示支持multipart/附件
helper.setFrom("your_email@example.com"); // 发件人
helper.setTo(to); // 收件人
helper.setSubject(subject); // 主题
helper.setText(content, true); // true表示内容是HTML
// 如果要添加附件
// File attachment = new File("/path/to/your/file.pdf");
// helper.addAttachment(attachment.getName(), attachment);
mailSender.send(message);
System.out.println("邮件发送成功 (Spring Boot)！");
} catch (MessagingException e) {
System.err.println("邮件发送失败 (Spring Boot)：" + e.getMessage());
e.printStackTrace();
}
}
// 示例：在某个地方调用
public static void main(String[] args) {
// 这部分需要在Spring Boot应用上下文中运行
// 例如，在你的Application类中或者一个测试类中
// SpringApplication.run(YourApplication.class, args);
// EmailService emailService = context.getBean(EmailService.class);
// emailService.sendSimpleEmail("recipient_email@example.com", "Spring Boot邮件测试", "Hello from Spring Boot!
This is a test email.
");
}
}我个人非常喜欢MimeMessageHelper，它把很多繁琐的MimeBodyPart和MimeMultipart操作都封装起来了，让发送复杂邮件变得非常直观。另外，在生产环境中，你可能还会考虑异步发送邮件，避免邮件发送的耗时操作阻塞主线程。Spring Boot可以配合@Async注解轻松实现异步发送，这对于提升用户体验和系统响应速度是很有价值的。你只需要在配置类上启用@EnableAsync，然后在发送邮件的方法上加上@Async即可。这种集成方式，无疑让邮件服务成为Spring Boot应用中一个非常自然且强大的组成部分。
