首页 > 软件编程 > java > RabbitMQ在springboot实现短信服务的异步通信

RabbitMQ在springboot中实现短信服务的异步通信方式

2026-05-19 16:46:10 作者：胡思乱想罢了~

RabbitMQ是一个开源消息中间件,适用于异步通信、应用解耦、可靠消息传递、灵活路由、延迟消息处理和分布式系统调等场景,SpringBoot使用需要新建队列、交换机并配置绑定,文章通过短信验证码服务为例,演示了RabbitMQ在项目中的应用场景和配置方法

springboot中RabbitMQ基本使用

RabbitMQ是一个开源的消息中间件

具有以下用途和优点：

异步通信：RabbitMQ可以作为应用程序之间进行异步通信的媒介，生产者可以将消息发送到RabbitMQ，而消费者可以从中获取消息并进行处理。这种异步通信可以实现系统各部分的解耦，提高系统的可伸缩性和性能。
应用解耦：通过使用RabbitMQ，不同的应用程序可以通过发送和接收消息来解耦，并减少应用之间的依赖。这样可以提高系统的灵活性，使系统更易于维护和扩展。
可靠消息传递：RabbitMQ确保消息传递的可靠性。它提供持久化和消息确认机制，即使在消息发送或消费者出现故障的情况下，也能保证消息的不丢失和不重复。
灵活的消息路由和交换：RabbitMQ支持多种消息路由模式和交换机类型，如直连、扇形、主题和头部交换机。这使得可以根据消息的内容和标签将消息路由到不同的队列中，满足各种复杂的应用场景。
延迟消息处理：RabbitMQ支持延迟消息的发送和处理，可以用于处理定时任务、延迟通知和调度等需求。
分布式系统中的协调：RabbitMQ在分布式系统中扮演着关键的角色，可以用于实现分布式系统的任务分发、事件发布订阅、分布式锁等。它提供了一种简单而强大的方式来处理分布式系统间的通信和协调机制。

RabbitMQ是一个功能强大、可靠性高且易于使用的消息中间件。它在异步通信、应用解耦、可靠消息传递、灵活的消息路由和交换、延迟消息处理以及分布式系统中的协调等方面具有广泛应用。

在SpringbBoot在使用首先需要在rabbitmq管理界面新建队列和交换机。

RabbitMQ支持多种类型的交换机，用于定义消息的路由规则。

以下是几种常见的交换机类型：

直连交换机（Direct Exchange）：根据消息的路由键（Routing Key）精确地将消息路由到匹配的队列。例如，通过将消息的路由键设置为特定的关键词，可以将消息发送到对应的队列，以便消费者进行处理。
扇形交换机（Fanout Exchange）：将消息广播到所有与交换机绑定的队列。无论消息的路由键是什么，扇形交换机都会将消息发送到所有绑定的队列中。适用于多个消费者需要处理相同消息的场景。
主题交换机（Topic Exchange）：根据路由键的模式进行匹配和路由。可以使用通配符符号“*”匹配一个单词，使用“#”匹配零个或多个单词。主题交换机可以满足更复杂的路由需求，可以将消息路由到多个队列。
头部交换机（Headers Exchange）：根据消息的头部属性进行匹配和路由。消息发布者在发送消息时可以在消息的头部添加自定义的属性，交换机将根据这些属性进行匹配和路由。

不同类型的交换机适用于不同的应用场景，开发者可以根据具体需求选择适合的交换机类型来进行消息路由和分发。

在项目中引入依赖

<!-- RabbitMQ -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-amqp</artifactId>
</dependency>

yml文件配置

rabbitmq的用户名和密码都为默认

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/market?useSSl=true&useUnicode=true$characterEncoding=utf-8&serverTimezone=GMT%2B8
    username: root
    password: 010409
  rabbitmq:
      host: 127.0.0.1
      port: 5672
      username: guest
      password: guest

交换机与队列绑定配置

@Configuration
public class RabbitMQConfig {
    private static final String MARKET = "market";
    private static final String ORDER = "order";
    private static final String EXCHANGE = "market.exChanges";
    @Bean
    public Queue queue01(){
        return new Queue(MARKET);
    }
    @Bean
    public Queue queue02(){
        return new Queue(ORDER);
    }
    @Bean
    public DirectExchange fanoutExchange(){
        return new DirectExchange(EXCHANGE);
    }
    // 绑定交换机和队列
    @Bean
    public Binding binding01(){
        return BindingBuilder.bind(queue01()).to(fanoutExchange()).with("market");
    }
    @Bean
    public Binding binding02(){
        return BindingBuilder.bind(queue02()).to(fanoutExchange()).with("order");
    }
}

应用场景

短信验证码服务，这里我使用的是阿里云短信服务SMS，将短信验证码与前端输入的手机号存入队列中，将验证码存入redis中，方便后续注册时验证码验证，最后监听队列拿到信息后发送短信。

SMS依赖与配置，需要将配置修改为自己的

<!--  阿里云短信依赖  -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.16</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-dysmsapi</artifactId>
    <version>2.1.0</version>
</dependency>

@Service
public class SmsService {
    public boolean send(Map<String, Object> param, String phone) {

        if(StringUtils.isEmpty(phone)) return false;
        //default 地域节点，默认就好  后面是 阿里云的 id和秘钥（这里记得去阿里云复制自己的id和秘钥哦）
        DefaultProfile profile = DefaultProfile.getProfile("default",  "LTAI5tNtEzgs7etoRVhWQuXz", "X8odaVou1eSwT0boKEgvYxPSUtWafL");
        IAcsClient client = new DefaultAcsClient(profile);

        CommonRequest request = new CommonRequest();

        request.setProtocol(ProtocolType.HTTPS);
        request.setMethod(MethodType.POST);
        request.setDomain("dysmsapi.aliyuncs.com");
        request.setVersion("2017-05-25");
        request.setAction("SendSms");

        request.putQueryParameter("PhoneNumbers", phone);  //手机号
        request.putQueryParameter("SignName", "阿里云短信测试");    //申请阿里云 签名名称（暂时用阿里云测试的，自己还不能注册签名）
        request.putQueryParameter("TemplateCode",  "SMS_154950909"); //申请阿里云 模板code（用的也是阿里云测试的）
        request.putQueryParameter("TemplateParam", JSONObject.toJSONString(param));

        try {
            CommonResponse response = client.getCommonResponse(request);
//            System.out.println(response.getData());
            return response.getHttpResponse().isSuccess();
        } catch (Exception e) {
            e.printStackTrace();
        }
        return false;
    }
}

发送短信的接口：

@RequestMapping("/sendCode")
public Result sendCode(String phone){
    return UserService.sendCode(phone);
}

实现：

   @Override
    public Result sendCode(String phone) {
        // 1.校验手机号
        String regex = "^1[3456789]\\d{9}$";

        if (!phone.matches(regex)) {
            // 2.如果不符合，返回错误信息
            return new Result(100,"手机号格式错误！");
        }

//      3. 生成验证码
        String code = "";
        for (int i = 0; i < 6; i++) {
            int var = new Random().nextInt(10);
            code = code + var;
        }

        Map<String,Object> param = new HashMap<>();
        param.put("code", code);

        // 4.保存验证码到 redis
        redisCache.setCacheObject(phone,code);

        Map<String,String> map=new HashMap();
        map.put("phone", phone);
        map.put("code", code);
        // 5.保存验证码和手机号到队列
        rabbitTemplate.convertAndSend("market.exChanges","market",map);

        return new Result(200, "发送成功");
    }

监听队列并发送短信。

@RabbitListener(queues = "market")
@RabbitHandler
public void executeSPC(Map<String, String> map, Channel channel, @Headers Map<String, Object> headers) throws IOException {
    try {
        Map<String,Object> param = new HashMap<>();
        param.put("code", map.get("code"));
        smsService.send(param, map.get("phone"));

        // 手动发送ACK，确认消息已接收
        Long deliveryTag = (Long) headers.get(AmqpHeaders.DELIVERY_TAG);
        channel.basicAck(deliveryTag, false);
    } catch (Exception e) {
        // 处理异常情况，根据业务需要选择是否重新入列或者拒绝消息等操作
        Long deliveryTag = (Long) headers.get(AmqpHeaders.DELIVERY_TAG);
        channel.basicNack(deliveryTag, false, true);
    }
}

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。