SpringBoot 发送邮件

文章目录

  • 参考文献
  • 1、发送邮件步骤
  • 2、遇到的问题


参考文献

  1. Springboot实现发送邮件功能
  2. 163邮箱常用端口号,一般使用SSL协议端口号,安全一点。

1、发送邮件步骤

  1. 邮件中开启 POP3/SMTP 服务;并且获取授权码(授权码只出现一次,记得复制下来)
  2. pom.xml 文件中引入 spring-boot-starter-mail 依赖;到 https://mvnrepository.com/ 网站找 maven 依赖;

<dependency>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-mailartifactId>
    <version>2.7.1version>
dependency>
  1. application.properties 中进行邮箱参数配置;
# MailProperties
spring.mail.host=smtp.163.com
spring.mail.port=465
[email protected]
spring.mail.password=xxxxxxxxxxxx #切记使用授权码,使用密码行不通
#启用加密连接
spring.mail.protocol=smtps
spring.mail.properties.mail.smtp.ssl.enable=true
  1. 使用 JavaMailSender 发送邮件:
    1. 创建 MailClient 工具类
    2. 注入 JavaMailSender 属性
    3. 从配置文件中定义发件人属性
    4. 创建一个 MimeMessage 对象
    5. 通过MimeMessageHelper定义邮件内容,并使用send方法传送出去
@Component
public class MailClient {

    private static final Logger logger = LoggerFactory.getLogger(MailClient.class);

    @Autowired
    private JavaMailSender mailSender;

    @Value("${spring.mail.username}")
    private String from;//定义发件人

    /**
     * 发送邮件功能
     * @param to,邮件目的地
     * @param subject,主题
     * @param content,邮件内容
     *
     * 发送邮件失败会保存日志
     */
    public void sendMail(String to, String subject, String content) {
        try {
            MimeMessage message = mailSender.createMimeMessage();
            MimeMessageHelper helper = new MimeMessageHelper(message);
            helper.setFrom(from);
            helper.setTo(to);
            helper.setSubject(subject);
            helper.setText(content, true);//不加参数默认是文本,加上true之后支持html格式文件
            mailSender.send(helper.getMimeMessage());
        } catch (MessagingException e) {
            logger.error("发送邮件失败:" + e.getMessage());
        }
    }
}
  1. 测试类测试是否可以使用(传普通文本文件和 html 文件稍有不同)
@SpringBootTest
public class MailTests {

    @Autowired
    private MailClient mailClient;

    @Autowired
    private TemplateEngine templateEngine;

    //测试发送文本文件
    @Test
    public void testTextMail() {
        mailClient.sendMail("[email protected]", "TEST", "Welcome.");
    }

    //测试发送html文件
    @Test
    public void testHtmlMail() {
        //给模板传context参数
        Context context = new Context();
        //传给模板的变量存进去
        context.setVariable("username", "sunday");
        //调用模板引擎生成动态网页
        String content = templateEngine.process("/mail/demo", context);
        System.out.println(content);

        mailClient.sendMail("[email protected]", "HTML", content);
    }
}

解释:

  • 普通文本文件直接定义收件人,文本主题,文本内容之后调用 工具类的 sendMail 方法就可以发送邮件了;
  • 对于 html 文件来说,需要使用 Context 类来定义要传给 thymeleaf 模板渲染的 html 文件的一些参数;并且主动调用 templateEngine(因此要注入templateEngine 属性)来生成动态网页;

注意:

  • 添加静态页面之后,需要 rebuild 一下,否则 target 文件夹中确实没有这个文件,也就是报错找不到文件(是 rebuild 而不是 build)。

html 文件示例:

DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>邮件示例title>
head>
<body>
    <p>欢迎你, <span style="color:red;" th:text="${username}">span>!p>
body>
html>

邮箱中收到的邮件:

SpringBoot 发送邮件_第1张图片

2、遇到的问题

  1. 错误1:授权码问题,配置文件中不是密码,是授权码
Caused by: javax.mail.AuthenticationFailedException: 535 Error: authentication failed

参考文献:
javax.mail.AuthenticationFailedException: 535 Error: authentication failed解决办法

  1. 错误2:最后发现真的是没有静态页面的问题,也就是 target 文件中没有 指定的 html 页面,没有 rebuild 的问题;
  2. 也可以删除 target 文件夹下的所有目录重新 build ,一样的效果。

参考文献:
报错org.thymeleaf.exceptions.TemplateInputException: Error resolving template解决方案

你可能感兴趣的:(java项目,spring,boot,java)