Springboot整合mqtt实现软硬件通信

原创 于 2025-11-19 19:30:14 发布 · 521 阅读 · 14 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring boot #后端 #java #mqtt #maven

文章目录

前言

本文实现Springboot整合mqtt，更好地实现物联网软硬件通信。

一、mqtt是什么？

MQTT 是消息队列遥测传输的缩写，是一种轻量级、基于发布 / 订阅模式的物联网通信协议。

应用场景：

  • 物联网设备通信，比如智能家居、工业传感器、穿戴设备。
  • 远程监控与数据采集，例如环境监测、设备状态上报。

注：这里实现的是软件后端层面的mqtt，是对硬件消息的接收和发送，如果要做一个完整的物联网项目，也需要硬件层面连接mqtt服务器，并且订阅、发布相关主题的信息。

二、物联网项目结构图

该图为完整的mqtt项目结构图。其中mqtt服务器部分可以用官方提供的公共的服务器，也可以在自己的服务器上搭建，只需要在后端配置文件添加mqtt服务器ip地址等相关信息。

注：Springboot项目不是自己内部开一个mqtt服务，所以我们只需要连接并使用相应的mqtt服务器即可。

三、实现代码

在pom.xml中引入Maven坐标：

        <dependency>
            <groupId>org.springframework.integration</groupId>
            <artifactId>spring-integration-mqtt</artifactId>
        </dependency>

在Springboot配置文件中配置mqtt服务器相关信息

spring:
  mqtt:
    url: tcp://broker.emqx.io:1883
    #用户名
    username: admin
    #密码
    password: 123456
    #客户端id（不能重复）
    client:
      id: consumer-id
    #MQTT默认的消息推送主题，实际可在调用接口时指定
    default:
      topic: topic

这里的mqtt服务器地址 tcp://broker.emqx.io:1883 是EMQX官方提供的一个公共的服务器，如果是想看一下初步效果，可以使用该服务器。

接下来我们可以放两部分代码，一部分就是接收消息，也就是订阅消息的部分，另一部分就是用来发布相关消息。

订阅消息部分：

@Configuration
public class MqttConsumerConfig {
    @Value("${spring.mqtt.username}")
    private String username;

    @Value("${spring.mqtt.password}")
    private String password;

    @Value("${spring.mqtt.url}")
    private String hostUrl;

    @Value("${spring.mqtt.client.id}")
    private String clientId;

    @Value("${spring.mqtt.default.topic}")
    private String defaultTopic;

    /**
     * 客户端对象
     */
    private MqttClient client;

    /**
     * 在bean初始化后连接到服务器
     */
    @PostConstruct
    public void init(){
        connect();
    }

    /**
     * 客户端连接服务端
     */
    public void connect(){
        try {

            client = new MqttClient(hostUrl,clientId,new MemoryPersistence());
            MqttConnectOptions options = new MqttConnectOptions();
            options.setCleanSession(true);
//            //设置连接用户名
//            options.setUserName(username);
//            //设置连接密码
//            options.setPassword(password.toCharArray());
            //设置超时时间，单位为秒
            options.setConnectionTimeout(100);
            //设置心跳时间 单位为秒，表示服务器每隔1.5*20秒的时间向客户端发送心跳判断客户端是否在线
            options.setKeepAliveInterval(20);
            //设置遗嘱消息的话题，若客户端和服务器之间的连接意外断开，服务器将发布客户端的遗嘱信息
            options.setWill("willTopic",(clientId + "与服务器断开连接").getBytes(),0,false);
            //设置回调
            client.setCallback(new MqttConsumerCallBack());
            client.connect(options);
            //订阅主题
            //消息等级，和主题数组一一对应，服务端将按照指定等级给订阅了主题的客户端推送消息
            int[] qos = {1};
            System.out.println("连接");
            //主题
            //String[] topics = {"data","status"};
            client.subscribe(topics,qos);
        } catch (MqttException e) {

            e.printStackTrace();
        }
    }

    /**
     * 断开连接
     */
    public void disConnect(){
        try {
            client.disconnect();
        } catch (MqttException e) {
            e.printStackTrace();
        }
    }


    /**
     * 订阅主题
     */
    public void subscribe(String topic,int qos){
        try {
            client.subscribe(topic,qos);
        } catch (MqttException e) {
            e.printStackTrace();
        }
    }
}

@Component
public class MqttConsumerCallBack implements MqttCallback{

    /**
     * 客户端断开连接的回调
     */


    @Override
    public void connectionLost(Throwable throwable) {
        System.out.println("与服务器断开连接，可重连");
    }

    /**
     * 消息到达的回调
     */
    @Override
    public void messageArrived(String topic, MqttMessage message) throws Exception {


        System.out.println(String.format("接收消息主题 : %s",topic));
        System.out.println(String.format("接收消息Qos : %d",message.getQos()));
        System.out.println(String.format("接收消息内容 : %s",new String(message.getPayload())));
        if(topic.equals("data")){
         
  System.out.println(String.format("接收消息retained : %b",message.isRetained()));
        }

        System.out.println(String.format("接收消息retained : %b",message.isRetained()));
    }


    /**
     * 消息发布成功的回调
     */
    @Override
    public void deliveryComplete(IMqttDeliveryToken iMqttDeliveryToken) {

    }

}

接下来是发布消息部分：

@Configuration
@Slf4j
public class MqttProviderConfig {
    @Value("${spring.mqtt.username}")
    private String username;

    @Value("${spring.mqtt.password}")
    private String password;

    @Value("${spring.mqtt.url}")
    private String hostUrl;

    private String clientId = "provider_id";

    @Value("${spring.mqtt.default.topic}")
    private String defaultTopic;

    /**
     * 客户端对象
     */
    private MqttClient client;

    /**
     * 在bean初始化后连接到服务器
     */
    @PostConstruct
    public void init(){
        connect();
    }

    /**
     * 客户端连接服务端
     */
    public void connect(){
        try{
           // System.out.println("Connecting to MQTT server: " + hostUrl + " with client ID: " + clientId);

            //创建MQTT客户端对象
            client = new MqttClient(hostUrl,clientId,new MemoryPersistence());

            //连接设置
            MqttConnectOptions options = new MqttConnectOptions();

            options.setCleanSession(true);
            //设置连接用户名
            options.setUserName(username);
            //设置连接密码
            options.setPassword(password.toCharArray());
            //设置超时时间，单位为秒
            options.setConnectionTimeout(100);
            //设置心跳时间 单位为秒，表示服务器每隔 1.5*20秒的时间向客户端发送心跳判断客户端是否在线
            options.setKeepAliveInterval(20);
            //设置遗嘱消息的话题，若客户端和服务器之间的连接意外断开，服务器将发布客户端的遗嘱信息
            options.setWill("willTopic",(clientId + "与服务器断开连接").getBytes(),0,false);
            //设置回调
            client.setCallback(new MqttProviderCallBack());

            client.connect(options);

        } catch(MqttException e){
            e.printStackTrace();
        }

    }
    public void publish(int qos,boolean retained,String topic,String message){
        MqttMessage mqttMessage = new MqttMessage(); //创建消息实例
        mqttMessage.setQos(qos);  //设置qos
        mqttMessage.setRetained(retained);  //设置是否保留信息
        mqttMessage.setPayload(message.getBytes());
        //主题的目的地，用于发布/订阅信息
        MqttTopic mqttTopic = client.getTopic(topic);
        //提供一种机制来跟踪消息的传递进度
        //用于在以非阻塞方式（在后台运行）执行发布是跟踪消息的传递进度
        MqttDeliveryToken token;
        try {
            //将指定消息发布到主题，但不等待消息传递完成，返回的token可用于跟踪消息的传递状态
            token = mqttTopic.publish(mqttMessage);
            token.waitForCompletion();
        } catch (MqttException e) {
            e.printStackTrace();
        }
    }

}

@Configuration
public class MqttProviderCallBack implements MqttCallback{

    @Value("${spring.mqtt.client.id}")
    private String clientId;
    /**
     * 与服务器断开的回调
     */
    @Override
    public void connectionLost(Throwable cause) {
        System.out.println(clientId+"与服务器断开连接");
    }

    /**
     * 消息到达的回调
     */
    @Override
    public void messageArrived(String topic, MqttMessage message) throws Exception {


    }

    /**
     * 消息发布成功的回调
     */
    @Override
    public void deliveryComplete(IMqttDeliveryToken token) {
        IMqttAsyncClient client = token.getClient();
        System.out.println(client.getClientId()+"发布消息成功！");

    }

}

接下来就是调用publish方法，传入相应参数，即可完成消息的发布。

这里有几个参数要注意一下：

一、MQTT Topic（消息路由核心）

Topic 是客户端发布 / 订阅消息的 “地址标识”，是实现 “发布 - 订阅” 模式的基础。

  • 核心属性：字符串格式，无预定义结构，由客户端自定义，比如 “device/light/ 客厅”“data/sensor/ 温度”。
  • 层级与通配符：用斜杠 “/” 划分层级，支持两种通配符订阅 ——“+” 匹配单个层级（如 “device/+/ 客厅” 匹配 “device/light/ 客厅”），“#” 匹配当前及所有子层级（如 “data/#” 匹配所有数据类主题）。
  • 核心规则：发布者仅需指定 Topic 发送消息，订阅者通过匹配 Topic（或通配符）接收消息，发布者与订阅者无直接关联，实现解耦。

二、MQTT QoS（消息传输质量等级）

QoS（Quality of Service）定义了消息从发布者到订阅者的传输可靠性，MQTT 3.1.1 标准规定了 3 个等级，优先级从低到高。

  1. QoS 0（最多一次）：消息仅发送一次，不确认、不重发，可能丢失。适用于对可靠性要求低的场景，如实时温度上报。
  2. QoS 1（至少一次）：消息确保送达，但可能重复。发布者发送后等待确认，未收到确认则重发，直到订阅者确认接收。
  3. QoS 2（恰好一次）：消息确保仅送达一次，无丢失、无重复。通过 “发布 - 确认 - 释放 - 完成” 四次握手实现，适用于金融交易、指令下发等关键场景。

三、MQTT Retained

Retained 消息是 Broker（服务器）为指定 Topic 保存的 “最新一条消息”，具备 “状态快照” 属性。

  • 发布时触发：客户端发布消息时，需显式设置 “Retain 标志位” 为 true，Broker 才会保存该消息。
  • 仅存最新：同一 Topic 后续发布的 Retained 消息会覆盖旧消息，Broker 始终只保留该 Topic 的最新状态。
  • 在有别的客户端订阅该Topic时，如果其“Retain 标志位” 为 true，一旦连接，客户端马上会收到一条保存的最后发布的该Topic的消息。

总结

本文详细描述了mqtt项目大致结构、Sringboot整合mqtt代码、mqtt的几个重要参数，希望对未来的架构师们有帮助，谢谢～

基于Java+springboot+vue+mqtt协议开发的智能家居系统
2301_76817904的博客
03-12 1295
基于Java+springboot+vue+mqtt协议开发的智能家居系统，是一套开源的软硬件系统，可用于二次开发和学习，快速搭建自己的智能家居系统。硬件工程师可以把自己的设备集成到系统；软件工程师可以使用项目中的设备熟悉软硬件交互。服务端使用spring boot、数据库mysql和redis、前端vue、移动端android、硬件端ESP-IDF和Arduino等。软硬件交互基于Mqtt协议，使用EMQ代理服务器。
Spring Boot：集成Mqtt实现消息的发送和接收
热门推荐
Crane的博客
06-10 1万+
使用<<Docker案例：Mac系统中构建MQTT容器及使用>>文章中创建的Mqtt Docker容器结合SpringBoot模拟实现消息的发送和接收。在实际应用场景中，Mqtt模块可集成在任何硬件设备，如手持终端、车载模块以及一些定制的电路板中，即有通信功能的“物”中。下面主要记录SpringBoot项目中集成Mqtt的步骤。 Springboot版本：2.2.6.RELEASE 。。。。。。
netty单片机通讯_SSM+Netty实现软硬件通信，真实项目案例
weixin_39817122的博客
12-18 335
前言今天分享的是MySelf自己以前工作项目中的一个模块实例实现的思路还有流程，在这过程中也是遇到了很多问题，能过顺利解决也是团队沟通的结果。项目模拟背景：假设我们有一个软件平台，我们的线下产品是一些探测器(传感器)硬件，它们需要在一定范围下定时上传数据给服务器，而且服务器可能还需要对他们下达命令(针对单个)，或者广播指令(针对全部)，且可能是在管理员的后台下令，也可能是在用户的小程序(APP)等...
MQTT的Java代码实现
weixin_44388391的博客
08-02 9826
MQTT基于SpringBoot框架实现
Java驱动的无人共享KTV：软硬件融合技术架构解析
小马总的博客
06-26 911
文章解析了Java技术在无人共享KTV系统中的核心应用。基于SpringBoot框架的跨平台特性，系统实现了硬件设备智能控制、实时数据处理及云边协同。功能上支持扫码开门、语音点歌、无感支付等自助化流程，并通过动态定价和设备自检提升运营效率。案例显示，该系统可降低60%人力成本，提升40%复购率。未来将结合AI和VR技术深化智能娱乐体验。Java技术的稳定性和扩展性有效推动了KTV行业的数字化升级。
Springboot应用的信创适配-补充
为无为，事无事，味无味。
06-22 5282
基于信创大背景,美创科技针对用户目前的数据库建设及网络架构现状,结合其业务情况以及国产化改造的具体诉求,提供数据库国产信创改造方案,涵盖:国产数据库选型指导,帮助用户制定国产数据库迁移方案,进行迁移实施,并且后续可持续提供国产数据库运维服务。
探秘Java无人自助唱K系统：软硬件融合的娱乐新势力
小马总的博客
06-24 694
Java无人自助唱K系统通过软硬件协同创新推动KTV行业数字化转型。系统采用SpringBoot+SpringCloud微服务架构，集成智能门锁、语音点歌、无感支付等功能，实现扫码开门到自动扣费的全流程自助化。核心技术包括MQTT设备控制、WebSocket实时交互和动态定价算法，使人力成本降低60%，营收增长25%。系统支持灯光音效联动、社交互动等沉浸式体验，并通过用户数据分析优化运营。未来将融合AI虚拟陪唱和VR技术，拓展元宇宙娱乐场景，成为"新娱乐"标杆案例。
无人共享KTV系统开发：JAVA技术栈下的软硬件融合创新
小马总的博客
06-26 642
无人共享KTV系统采用Java技术栈实现软硬件融合创新，通过SpringBoot+SpringCloud微服务架构整合智能设备，提供扫码开门、智能点歌、无感支付等无人化功能。系统应用边缘计算和AI技术实现设备自检、虚拟陪唱等智能服务，降低60%-70%人力成本，提升40%-50%包厢周转率。典型案例显示，该系统可提升用户复购率40%，月营收增长25%。未来将结合AI、元宇宙和5G技术，拓展虚拟KTV等创新场景，推动行业可持续发展。
探秘Java技术：无人自助唱K软硬件一体化系统新突破
小马总的博客
06-24 883
Java技术驱动的无人自助唱K系统实现软硬件深度整合，通过SpringBoot微服务架构和物联网通信协议（MQTT/RXTX）控制智能门锁、音响等设备，支持扫码开门、语音点歌和无感支付全流程自助服务。系统具备动态定价、AI曲目推荐和设备自检功能，显著降低60%人力成本，提升40%包厢周转率。典型案例显示部署后用户复购率提升40%，单店营收增长25%。未来将融合AI虚拟陪唱和元宇宙VR技术，进一步优化娱乐体验与节能运营。
基于SpringBoot的电子硬件毕业设计资源
论文部分应详细阐述选题背景、国内外研究现状、系统总体架构设计、软硬件技术选型、功能模块划分、关键技术实现（如SpringBoot整合MyBatis/JPA、WebSocket实时通信、定时任务调度、安全性设计）、实验测试结果分析等...
深入理解 Spring Boot 高级特性：条件化 Bean 注册机制
最新发布
刘一说的IT专栏
11-17 1012
摘要 Spring Boot通过条件化Bean注册机制实现灵活配置，核心是@Conditional注解和Condition接口。Spring Boot提供了一系列开箱即用的条件注解（如@ConditionalOnClass、@ConditionalOnProperty等），支持按类路径、配置属性、Profile等条件动态注册Bean。这种机制实现了关注点分离、自动装配和环境自适应，适用于数据库切换、功能开关、多数据源等场景。开发者也可自定义条件，通过实现Condition接口创建特定逻辑，如仅在Linux系
Spring Boot接收参数的19种方式
2509_94005872的博客
11-15 654
可以通过实现来自定义参数解析逻辑。
Spring Boot 3.3.4 升级导致 Logback 之前回滚策略配置不兼容问题解决
2509_94005118的博客
11-15 522
在将 Spring Boot 项目升级至 3.3.4 版本后，遇到 Logback 配置的兼容性问题。本文将详细描述该问题的错误信息、原因分析，并提供调整日志回滚策略的解决方案。在 Spring Boot 升级至 3.3.4 后，由于底层 Logback 版本的更新，原先使用的类和日志文件名中的%i令牌会引发兼容性问题。通过调整日志回滚策略，使用新的并去除不兼容的文件命名模式，可以顺利解决这些问题，使日志系统恢复正常运行。
Vue 3 + Vite 集成 Spring Boot 完整部署指南 - 前后端一体化打包方案
码码哈哈的博客
11-14 630
本文档提供了将 Vue 3 (Vite) 前端项目无缝集成到 Spring Boot 后端的完整解决方案。涵盖从开发环境配置到生产环境部署的全流程，详细说明了 Vite 构建配置、Spring MVC 静态资源处理、Vue Router History 模式支持等关键技术点。通过本指南，开发者可以实现前后端项目的一体化打包部署，将 Vue 构建产物直接输出到 Spring Boot 的 static 目录，最终打包成单个可执行 JAR 文件，简化部署流程并降低运维成本。
Spring Boot + Spring AI快速体验
2509_94034411的博客
11-16 768
Spring AI是Spring的一个子项目，是Spring专门面向于AI的应用框架。Spring AI 项目旨在简化整合人工智能功能的应用程序开发，避免不必要的复杂性。汲取了著名的 Python 项目 LangChain 和 LlamaIndex 的灵感，但 Spring AI 并不是这些项目的直接移植。该项目的成立的信念：下一波生成式人工智能应用程序不仅将面向Python开发人员，而且将在许多编程语言中无处不在。@Bean。
Spring Boot + MyBatis 整合与 MyBatis 原理全解析
写代码写久了才发现：人生和程序一样，经常 Bug 多、需求乱，重构难，但总能跑起来。这个博客记录我从迷茫到搞懂、从踩坑到归纳、从混乱到清晰的过程。写给过去迷茫的自己，也写给同样在路上折腾的你。没有炫技，没有玄学，只有真实的思考、实践和成长。
11-15 594
摘要： MyBatis作为企业级Java项目中广泛使用的数据访问框架，与Spring Boot整合紧密。文章首先介绍了MyBatis的核心特点：SQL可控性强、性能高、对DBA友好。随后详细剖析了其与Spring Boot的整合机制，包括自动创建SqlSessionFactory、扫描Mapper接口并生成动态代理对象。重点讲解了MyBatis的执行流程：通过Mapper代理找到SQL，由Executor执行，最终通过ResultSetHandler处理结果集。此外，还阐述了动态SQL的实现原理、缓存机制（
从零搭建高并发Web服务：Spring Boot + Redis实战（10W+ QPS优化方案）
SZHYN的博客
11-14 961
传统单体架构在此类场景下极易崩溃。本文将通过一个完整的实战案例，手把手教你使用。的高并发Web服务，覆盖从环境搭建到性能调优的全流程。：Lua脚本报错“too many results”在电商秒杀、社交媒体热点等场景下，系统可能面临。策略，通过消息队列异步更新数据库。：确保脚本返回单一结果，或使用。：缓存与数据库数据不一致。：Redis连接池耗尽。假设我们需要实现一个。
Spring Boot实时推送技术详解：三个经典案例
2509_94006364的博客
11-14 496
id: ID!实现Resolver：处理GraphQL查询和订阅请求。@Component// 模拟消息发布});前端处理：前端使用GraphQL客户端订阅新消息，并处理接收到的数据。GraphQL订阅的优势在于能够精确请求所需数据，并且能够在数据变化时实时推送更新。本文介绍了三种使用Spring Boot实现实时消息推送的方法：长轮询、WebSocket和GraphQL订阅。每种方法都有其独特的优势和适用场景。
在Spring Boot项目中引入本地JAR包的步骤和配置
2509_94104749的博客
11-14 407
通过本文的介绍，读者可以了解到如何在Spring Boot项目中引入本地JAR包并进行相应的配置。无论是使用Maven还是Gradle，本文提供的步骤和代码示例都可以帮助开发者顺利完成本地JAR包的引入和使用。本文将详细介绍如何在Spring Boot项目中引入本地JAR包的步骤和配置，并提供相应的代码示例。假设我们有一个名为my-library.jar的本地JAR包，并且它位于项目的根目录下的libs文件夹中。引入本地JAR包后，可以在Spring Boot项目中使用其中的类和方法。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序陆

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值