利用 SpringBoot+rabbitmq 实现邮件异步发送，保证 100% 投递成功

作者：快乐非自愿限量之名

2024-07-11
福建
本文字数：4352 字
阅读完需：约 14 分钟

在之前的文章中，我们详细介绍了 SpringBoot 整合 mail 实现各类邮件的自动推送服务。

但是这类服务通常不稳定，当出现网络异常的时候，会导致邮件推送失败。

本篇文章将介绍另一种高可靠的服务架构，实现邮件 100% 被投递成功。类似的短信自动发送等服务也大体相同。

一、先来一张流程图

本文内容主要围绕这个流程图展开，利用 RabbitMQ 消息队列来实现邮件 100% 被投递，内容涵盖了 RabbitMQ 很多知识点，如：

生产者和消费者模型
消息发送确认机制
消费确认机制
消息的重新投递

二、实现思路

1.准备一台 Linux 服务器，并安装 RabbitMQ
2.开放 QQ 邮箱或者其它邮箱授权码，用于发送邮件
3.创建邮件发送项目并编写代码
4.发送邮件测试
5.消息发送失败处理

三、环境准备

获取邮箱授权码的目的，主要是为了通过代码进行发送邮件，例如 QQ 邮箱授权码获取方式，如下图：

点击【开启】按钮，然后发送短信，即可获取授权码，该授权码就是配置文件spring.mail.password需要的密码！

四、项目介绍

springboot 版本：2.1.5.RELEASE
RabbitMQ 版本：3.6.5
SendMailUtil：发送邮件工具类
ProduceServiceImpl：生产者，发送消息
ConsumerMailService：消费者，消费消息，发送邮件

五、代码实现

5.1、创建项目

在 IDEA 下创建一个名称为smail的 Springboot 项目，pom文件中加入amqp和mail。

<dependencies>    <!--spring boot核心-->    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter</artifactId>    </dependency>    <!--spring boot 测试-->    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-test</artifactId>        <scope>test</scope>    </dependency>    <!--springmvc web-->    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-web</artifactId>    </dependency>    <!--开发环境调试-->    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-devtools</artifactId>        <optional>true</optional>    </dependency>    <!--mail 支持-->    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-mail</artifactId>    </dependency>    <!--amqp 支持-->    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-amqp</artifactId>    </dependency>    <!-- commons-lang3 -->    <dependency>        <groupId>org.apache.commons</groupId>        <artifactId>commons-lang3</artifactId>        <version>3.4</version>    </dependency>    <!--lombok-->    <dependency>        <groupId>org.projectlombok</groupId>        <artifactId>lombok</artifactId>        <version>1.16.10</version>    </dependency></dependencies>

复制代码

5.2、配置 rabbitMQ、mail

在application.properties文件中，配置amqp和mail！

#rabbitmqspring.rabbitmq.host=192.168.0.103spring.rabbitmq.port=5672spring.rabbitmq.username=guestspring.rabbitmq.password=guest# 开启confirms回调 P -> Exchangespring.rabbitmq.publisher-confirms=true# 开启returnedMessage回调 Exchange -> Queuespring.rabbitmq.publisher-returns=true# 设置手动确认(ack) Queue -> Cspring.rabbitmq.listener.simple.acknowledge-mode=manualspring.rabbitmq.listener.simple.prefetch=100
# mailspring.mail.default-encoding=UTF-8spring.mail.host=smtp.qq.comspring.mail.username=xxxx@qq.comspring.mail.password=获取的邮箱授权码spring.mail.from=xxxx@qq.comspring.mail.properties.mail.smtp.auth=truespring.mail.properties.mail.smtp.starttls.enable=truespring.mail.properties.mail.smtp.starttls.required=true

复制代码

其中，spring.mail.password第四步中获取的授权码，同时username和from要一致！

5.3、RabbitConfig 配置类

@Configuration@Slf4jpublic class RabbitConfig {
    // 发送邮件    public static final String MAIL_QUEUE_NAME = "mail.queue";    public static final String MAIL_EXCHANGE_NAME = "mail.exchange";    public static final String MAIL_ROUTING_KEY_NAME = "mail.routing.key";
    @Autowired    private CachingConnectionFactory connectionFactory;
    @Bean    public RabbitTemplate rabbitTemplate() {        RabbitTemplate rabbitTemplate = new RabbitTemplate(connectionFactory);        rabbitTemplate.setMessageConverter(converter());
        // 消息是否成功发送到Exchange        rabbitTemplate.setConfirmCallback((correlationData, ack, cause) -> {            if (ack) {                log.info("消息成功发送到Exchange");            } else {                log.info("消息发送到Exchange失败, {}, cause: {}", correlationData, cause);            }        });
        // 触发setReturnCallback回调必须设置mandatory=true, 否则Exchange没有找到Queue就会丢弃掉消息, 而不会触发回调        rabbitTemplate.setMandatory(true);        // 消息是否从Exchange路由到Queue, 注意: 这是一个失败回调, 只有消息从Exchange路由到Queue失败才会回调这个方法        rabbitTemplate.setReturnCallback((message, replyCode, replyText, exchange, routingKey) -> {            log.info("消息从Exchange路由到Queue失败: exchange: {}, route: {}, replyCode: {}, replyText: {}, message: {}", exchange, routingKey, replyCode, replyText, message);        });
        return rabbitTemplate;    }
    @Bean    public Jackson2JsonMessageConverter converter() {        return new Jackson2JsonMessageConverter();    }
    @Bean    public Queue mailQueue() {        return new Queue(MAIL_QUEUE_NAME, true);    }
    @Bean    public DirectExchange mailExchange() {        return new DirectExchange(MAIL_EXCHANGE_NAME, true, false);    }
    @Bean    public Binding mailBinding() {        return BindingBuilder.bind(mailQueue()).to(mailExchange()).with(MAIL_ROUTING_KEY_NAME);    }}

复制代码

5.4、Mail 邮件实体类

@Getter@Setter@NoArgsConstructor@AllArgsConstructorpublic class Mail {
    // 目标邮箱    private String to;
    // 标题    private String title;
    // 正文    private String content;        // 消息ID    private String msgId;}

复制代码

5.5、SendMailUtil 邮件发送类

@Component@Slf4jpublic class SendMailUtil {
    @Value("${spring.mail.from}")    private String from;
    @Autowired    private JavaMailSender mailSender;
    /**     * 发送简单邮件     *     * @param mail     */    public boolean send(Mail mail) {        String to = mail.getTo();// 目标邮箱        String title = mail.getTitle();// 邮件标题        String content = mail.getContent();// 邮件正文
        SimpleMailMessage message = new SimpleMailMessage();        message.setFrom(from);        message.setTo(to);        message.setSubject(title);        message.setText(content);
        try {            mailSender.send(message);            log.info("邮件发送成功");            return true;        } catch (MailException e) {            log.error("邮件发送失败, to: {}, title: {}", to, title, e);            return false;        }    }}

复制代码

5.6、ProduceServiceImpl 生产者类

@Servicepublic class ProduceServiceImpl implements ProduceService {
    @Autowired    private RabbitTemplate rabbitTemplate;
    @Override    public boolean send(Mail mail) {        //创建uuid        String msgId = UUID.randomUUID().toString().replaceAll("-", "");        mail.setMsgId(msgId);                //发送消息到rabbitMQ        CorrelationData correlationData = new CorrelationData(msgId);        rabbitTemplate.convertAndSend(RabbitConfig.MAIL_EXCHANGE_NAME, RabbitConfig.MAIL_ROUTING_KEY_NAME, MessageHelper.objToMsg(mail), correlationData);
        return true;    }}

复制代码

5.7、ConsumerMailService 消费者类

@Component@Slf4jpublic class ConsumerMailService {
    @Autowired    private SendMailUtil sendMailUtil;
    @RabbitListener(queues = RabbitConfig.MAIL_QUEUE_NAME)    public void consume(Message message, Channel channel) throws IOException {        //将消息转化为对象        String str = new String(message.getBody());        Mail mail = JsonUtil.strToObj(str, Mail.class);        log.info("收到消息: {}", mail.toString());
        MessageProperties properties = message.getMessageProperties();        long tag = properties.getDeliveryTag();
        boolean success = sendMailUtil.send(mail);        if (success) {            channel.basicAck(tag, false);// 消费确认        } else {            channel.basicNack(tag, false, true);        }    }}

复制代码

5.8、TestController 控制层类

@RestController@RequestMapping("/test")@Slf4jpublic class TestController {
    @Autowired    private ProduceService testService;
    @PostMapping("send")    public boolean sendMail(Mail mail) {        return testService.send(mail);    }}

复制代码

六、测试服务

启动 SpringBoot 服务之后，用 postman 模拟请求接口。

查看控制台信息。

查询接受者邮件信息。

邮件发送成功！

七、小结

本文主要是通过发送邮件这个业务案例，来讲解 Springboot 与 rabbitMQ 技术的整合和使用！

使用了 rabbitMQ 的手动确认模式，当开启了之后，必须手动调用 ack 或者 nack 方法，否则消息会一直存储在 rabbitMQ 服务器中。

文章转载自：潘志的研发笔记
原文链接：https://www.cnblogs.com/dxflqm/p/18293317
体验地址：http://www.jnpfsoft.com/?from=infoq

发布于: 刚刚阅读数: 2

快乐非自愿限量之名

关注

还未添加个人签名 2023-06-19 加入

还未添加个人简介

发布

暂无评论

创作场景

利用 SpringBoot+rabbitmq 实现邮件异步发送，保证 100% 投递成功

一、先来一张流程图

二、实现思路

三、环境准备

四、项目介绍

五、代码实现

5.1、创建项目

5.2、配置 rabbitMQ、mail

5.3、RabbitConfig 配置类

5.4、Mail 邮件实体类

5.5、SendMailUtil 邮件发送类

5.6、ProduceServiceImpl 生产者类

5.7、ConsumerMailService 消费者类

5.8、TestController 控制层类

六、测试服务

七、小结

快乐非自愿限量之名

评论