要使用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里加:
<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>jakarta.mail</artifactId>
    <version>2.0.1</version> <!-- 或者更高版本,根据你项目需求来 -->
</dependency>
<dependency>
    <groupId>jakarta.activation</groupId>
    <artifactId>jakarta.activation-api</artifactId>
    <version>2.0.1</version>
</dependency>接着,就是编写发送邮件的代码了。我个人觉得,最关键的是理解邮件会话(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认证,而是需要你生成一个“授权码”或“应用专用密码”。这个在你的邮箱设置里通常能找到。
发送纯文本邮件固然简单,但在实际应用中,我们经常需要发送带有格式的HTML邮件,或者附带文件。JavaMail API当然考虑到了这一点,它通过MimeMultipart和MimeBodyPart来优雅地处理这些复杂场景。这就像你要寄一封信,信里不仅有文字,还想塞一张照片进去,或者信纸本身就是彩色的、有排版的。

要发送HTML内容,你只需要在设置邮件内容时,指定其MIME类型为text/html:
// ... (前面的Session和MimeMessage创建保持不变) ...
// 设置HTML邮件内容
String htmlContent = "<h1>你好!</h1>"
                   + "<p>这是一封<b>HTML</b>格式的测试邮件,通过Java发送。</p>"
                   + "<p>希望你能看到漂亮的排版和加粗的文字!</p>"
                   + "<img src='https://example.com/some_image.png' alt='示例图片' width='100' height='100'>"; // 也可以包含图片链接
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 = "<h1>你好!</h1>"
                       + "<p>这是一封带有<b>附件</b>的测试邮件,通过Java发送。</p>"
                       + "<p>请查收附件。</p>";
    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发送邮件的过程中,我遇到过不少“坑”。这些问题往往不是代码逻辑上的错误,而是配置、网络或者邮件服务商策略导致的。理解这些常见问题及其解决方案,能让你在遇到困难时少走很多弯路。
认证失败 (Authentication Failed):
AuthenticationFailedException,通常提示用户名或密码错误。连接超时或无法连接 (Connection Timeout/Could not connect to SMTP host):
ConnectException 或 SocketTimeoutException,提示无法连接到SMTP主机或连接超时。mail.smtp.host 和 mail.smtp.port 配置正确。例如,Gmail的SMTP是smtp.gmail.com,端口通常是587(TLS)或465(SSL)。ping smtp.example.com 或 telnet smtp.example.com 587 来测试连通性。SSL/TLS握手失败 (SSL/TLS Handshake Failure):
PKIX path building failed 或 Could not convert socket to TLS。mail.smtp.starttls.enable 设置为 true (对于587端口) 或 mail.smtp.ssl.enable 设置为 true (对于465端口)。cacerts文件是最新的,或者手动导入证书。邮件地址格式不正确 (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,那么恭喜你,发送邮件这事儿会变得异常简单和优雅。Spring Boot提供了一个spring-boot-starter-mail模块,它自动配置了JavaMailSender,让你几乎不用关心JavaMail API的底层细节。我个人觉得,这是Spring Boot最让人省心的地方之一。
首先,在你的pom.xml里引入这个Starter:
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>接着,在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邮件测试", "<h1>Hello from Spring Boot!</h1><p>This is a test email.</p>");
    }
}我个人非常喜欢MimeMessageHelper,它把很多繁琐的MimeBodyPart和MimeMultipart操作都封装起来了,让发送复杂邮件变得非常直观。另外,在生产环境中,你可能还会考虑异步发送邮件,避免邮件发送的耗时操作阻塞主线程。Spring Boot可以配合@Async注解轻松实现异步发送,这对于提升用户体验和系统响应速度是很有价值的。你只需要在配置类上启用@EnableAsync,然后在发送邮件的方法上加上@Async即可。这种集成方式,无疑让邮件服务成为Spring Boot应用中一个非常自然且强大的组成部分。
以上就是如何用Java发送邮件 Java发送邮件的步骤与示例的详细内容,更多请关注php中文网其它相关文章!
 
                        
                        每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
 
                 
                                
                                 收藏
收藏
                                                                             
                                
                                 收藏
收藏
                                                                             
                                
                                 收藏
收藏
                                                                            Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号