【调试工具|mqtt-spy】mqtt客户端调试工具 mqtt-spy 详细使用教程

博客主页：https://blog.csdn.net/wkd_007
博客内容：嵌入式开发、Linux、C语言、C++、数据结构、音视频
本文内容：mqtt-spy的下载、使用教程
金句分享：人生就像射箭，梦想就像箭靶子，如果连箭靶子都找不到的话，你每天拉弓有什么意义? ——《银河补习班》

---

一、概述

mqtt-spy 是一个开源的 MQTT（Message Queuing Telemetry Transport）客户端工具，用于监控和测试 MQTT 代理服务器。它是基于 Java 开发的，可以在多个操作系统上运行，包括 Windows、Linux 和 macOS。mqtt-spy 提供了丰富的功能，使用户能够轻松地与 MQTT 代理进行交互、监视 MQTT 消息流并进行测试。

以下是 mqtt-spy 的一些主要特点和功能：

• MQTT 客户端：mqtt-spy 允许您模拟 MQTT 客户端，可以连接到 MQTT 代理服务器并发布/订阅主题。这使您能够轻松地与 MQTT 代理进行通信并测试其功能。

• 实时监控：您可以使用 mqtt-spy 实时监视 MQTT 代理上的消息流。这包括显示已发布和已订阅消息以及与主题相关的其他信息。监控界面可以帮助您了解 MQTT 代理的运行状况。

• 消息编辑和发送：mqtt-spy 允许您编辑和发送 MQTT 消息，以便进行测试和调试。您可以指定消息的主题、负载和其他属性，并查看消息的发布情况。

• 订阅管理：您可以轻松地添加、编辑和删除已订阅的主题，以便跟踪感兴趣的消息。

• 消息记录：mqtt-spy 可以记录 MQTT 代理上的消息，以供稍后查看和分析。这对于调试和故障排除非常有用。

• SSL/TLS 支持：mqtt-spy 支持通过 SSL/TLS 安全通信协议连接到 MQTT 代理，以保护数据传输的安全性。

• 批量操作：您可以使用 mqtt-spy 执行批量操作，例如批量发布消息或批量订阅主题，以简化测试和操作。

• 用户友好的界面：mqtt-spy 提供了直观的用户界面，使用户能够轻松地使用和配置工具。

二、下载和安装 mqtt-spy

mqtt-spy是开源的。
项目开源地址：https://github.com/eclipse/paho.mqtt-spy
发布版本下载地址：https://github.com/eclipse/paho.mqtt-spy/releases

注意：mqtt-spy 是基于 Java 的应用程序，因此需要安装 Java 运行时环境 (JRE)。我之前安装过了，这里无法演示，不清楚可以去网上搜索怎样安装jre。

三、mqtt-spy 的使用

3.1 运行mqtt-spy

下载完mqtt-spy-1.0.1-beta-b18-jar-with-dependencies.jar后，window系统安装完jre后，直接双击运行。
界面如下：

3.2 创建连接

在Connectivity标签页，填mqtt服务器的ip和端口号，其他的不需要修改

如果服务器有要求认证的，需要填用户名和密码，跟进自己mqtt服务器而定，点击open connection：

在弹出的询问窗口点击是：

然后会弹出提示，点击确定

最后在主窗口显示有一个连接，且显示绿色，表示连接成功。

点击标签页的连接窗口，可以看到该连接的发布消息窗口(Publish message)、订阅和接收消息窗口(Subscriptions and received message)，这两个窗口比较常用，这些窗口都可以通过点击右边的按钮来分离成单独窗口。

3.3 发布消息(Publish message)

发布消息是在Publish message窗口，先点击窗口右边的设置按钮，然后选择Detech to a seperate window，分离成独立窗口，便于看信息：

然后填写Topic值和Data值，点击Publish发布即可：
注意：Topic值、Data值，需要按照mqtt服务器的协议来填写。下图是我使用的mqtt服务器的协议，对读者没用参考意义：

3.3 订阅、接收消息

订阅消息，点击New，然后填写Topic(主题)过滤，然后点击Subscribe：
这个Topic(主题)的值是根据mqtt服务器支持的协议来填写。下图是我使用的mqtt服务器的协议，对读者没用参考意义。

当服务器有该主题相关的消息发布时，窗口就会显示消息，参考下图：

四、总结

总的来说，mqtt-spy 是一个功能强大的 MQTT 客户端工具，适用于 MQTT 开发、测试和监控。它对于管理 MQTT 消息流、调试 MQTT 应用程序以及确保 MQTT 代理的正常运行非常有帮助。如果在开发mqtt的客户端或服务端的话，mqtt-spy 可能是一个很有有用的选择。

如果文章有帮助的话，点赞、收藏⭐，支持一波，谢谢