Java发送邮件配置及代码详解

本篇文章给大家分享《Java发送邮件配置与代码教程》，覆盖了文章的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

要在Spring Boot项目中实现邮件发送功能，首先需添加spring-boot-starter-mail依赖，接着在配置文件中设置邮箱信息如host、port、username和授权码等，然后通过注入JavaMailSender类编写邮件服务逻辑，最后可通过Controller或测试类调用发送邮件。具体步骤为：1. 添加Spring Boot邮件依赖；2. 配置QQ邮箱SMTP参数；3. 编写邮件发送服务类；4. 编写Controller测试接口并注意常见问题如授权码、端口限制及发件人一致性等。

实现邮件发送功能在Java项目中很常见，比如用户注册通知、订单确认、系统告警等场景。JavaMail 是 Java 提供的一套用于发送和接收电子邮件的 API，结合 Spring Boot 使用更是简单高效。下面我会从配置到代码一步步讲清楚如何用 Java 实现邮件发送。

1. 添加依赖

如果你使用的是 Spring Boot，首先要在 pom.xml 中添加邮件相关的依赖：

    org.springframework.boot
    spring-boot-starter-mail

这个依赖会自动引入 JavaMail 的相关类，并提供对邮件发送的封装。

2. 配置邮箱信息

邮件发送需要一个可用的邮箱账号作为发件人，常见的如 QQ 邮箱、网易邮箱、Gmail 等。以 QQ 邮箱为例，在 application.yml 或 application.properties 中进行如下配置：

application.yml 示例：

spring:
  mail:
    host: smtp.qq.com
    port: 465
    username: your-qq@qq.com
    password: 授权码（不是登录密码）
    protocol: smtp
    properties:
      mail:
        smtp:
          ssl:
            enable: true

几点说明：

• host：QQ 邮箱的 SMTP 地址是 smtp.qq.com
• port：SSL 模式下通常是 465，非 SSL 可能是 25 或 587
• password：不是你的登录密码，而是去邮箱设置里生成的“授权码”
• ssl.enable：QQ 邮箱强制要求启用 SSL 加密

3. 编写邮件发送工具类或 Service

Spring Boot 提供了 JavaMailSender 工具类，我们可以注入它来发送邮件。下面是一个简单的服务类示例：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;

@Service
public class EmailService {

    @Autowired
    private JavaMailSender javaMailSender;

    public void sendSimpleEmail(String to, String subject, String text) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom("your-qq@qq.com"); // 发件人
        message.setTo(to);                  // 收件人
        message.setSubject(subject);        // 主题
        message.setText(text);              // 内容

        javaMailSender.send(message);
    }
}

这是一个发送纯文本邮件的方法。如果要发送 HTML 格式的邮件，可以改用 MimeMessage 和 MimeMessageHelper 来构造更复杂的邮件内容。

4. 测试与调用

你可以通过 Controller 或者单元测试来触发邮件发送。例如写一个简单的 Controller：

@RestController
@RequestMapping("/email")
public class EmailController {

    @Autowired
    private EmailService emailService;

    @GetMapping("/send")
    public String sendEmail() {
        emailService.sendSimpleEmail("someone@example.com", "测试邮件", "这是一封测试邮件，请查收");
        return "邮件已发送";
    }
}

访问 /email/send 接口后，目标邮箱应该就会收到一封测试邮件。

常见问题与注意事项

• 授权码错误：很多同学一开始没搞明白“授权码”是什么，记得去邮箱设置里开启 SMTP 并获取授权码。
• 防火墙或网络限制：有些服务器环境可能限制了 465 端口，需要联系运维确认是否开放。
• 发件人地址不一致：设置的 from 必须和你使用的邮箱一致，否则会被拒绝。
• 频繁发送被封号：不要短时间内大量发送邮件，容易被识别为垃圾邮件甚至封号。

基本上就这些。配置看起来有点多，但只要按照步骤一步步来，其实不复杂，只是有些细节容易忽略。

好了，本文到此结束，带大家了解了《Java发送邮件配置及代码详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！