当前位置：首页 > 文章列表 > 文章 > java教程 > Java邮件发送配置与代码详解

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

2025-09-05 15:29:57 0浏览收藏

想要在Java项目中轻松实现邮件发送功能？本文以Spring Boot为基础，提供了一份详尽的Java邮件发送配置及代码教程，助你快速集成邮件功能！文章从添加`spring-boot-starter-mail`依赖开始，详细讲解了如何在`application.yml`或`application.properties`中配置QQ邮箱SMTP参数，包括host、port、username及关键的授权码设置。同时，通过实例代码展示了如何利用`JavaMailSender`编写邮件发送服务类，并提供Controller测试接口进行验证。此外，还总结了常见的邮件发送问题，如授权码错误、端口限制及发件人一致性等，助你避坑，顺利实现用户注册通知、订单确认、系统告警等常见场景的邮件发送需求。快来学习吧，让你的Java应用拥有强大的邮件发送能力！

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

Java实现邮件发送功能的详细配置与代码示例

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

1. 添加依赖

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

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

这个依赖会自动引入 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 接口后，目标邮箱应该就会收到一封测试邮件。