Hoppscotch中MQTT连接失败需依次检查：一、基础参数（协议/地址/端口/客户端ID）；二、TLS/SSL配置（mqtts/wss、证书校验）；三、用户名密码认证；四、订阅发布验证；五、遗嘱消息调试。

如果您尝试在Hoppscotch中测试MQTT协议消息，但连接失败或消息无法正常收发，则可能是由于MQTT连接参数配置错误、网络协议不匹配或TLS/SSL安全设置不当所致。以下是解决此问题的步骤：

一、配置MQTT基础连接参数

该方法用于建立基本的MQTT连接，确保客户端能与Broker成功握手。需准确填写协议类型、主机地址、端口及客户端ID等核心字段，避免因参数缺失导致连接拒绝。

1、在Hoppscotch主界面左侧导航栏点击“MQTT”协议入口。

2、在“Connection”区域填写Broker地址，例如：broker.hivemq.com（公共测试Broker）。

3、设置端口号：非加密连接使用1883，TLS加密连接使用8883。

4、输入唯一客户端ID，如hoppscotch-client-001，不可为空且不可重复。

5、点击“Connect”按钮发起连接，观察右下角状态提示是否显示“Connected”。

二、启用TLS/SSL加密连接

该方法用于在生产环境或受保护网络中建立安全MQTT通道，防止明文传输被窃听或篡改。需正确选择协议前缀并启用证书验证选项。

1、在协议下拉菜单中选择mqtts（MQTT over TLS）或wss（WebSocket Secure）。

2、确认Broker地址为支持TLS的域名，如test.mosquitto.org。

3、勾选“Enable TLS verification”复选框以启用服务器证书校验。

4、若使用自签名证书，在高级选项中上传CA证书文件（.pem格式）。

5、点击“Connect”，等待连接状态变为绿色“Secure Connected”。

三、配置用户名密码认证

该方法用于接入需要身份鉴权的私有MQTT Broker，避免因认证失败触发连接中断或拒绝订阅。

1、展开“Authentication”高级设置区域。

2、在“Username”字段填入授权账号，例如：testuser。

3、在“Password”字段填入对应密码，注意区分大小写与特殊字符转义。

4、确认Broker已启用MQTT 3.1.1及以上版本，并支持标准AUTH流程。

5、重新点击“Connect”，检查响应日志中是否出现“Auth success”标识。

四、订阅与发布消息验证通信链路

该方法用于确认MQTT连接建立后能否完成完整的消息流转闭环，包括主题订阅、消息接收与主动发布功能。

1、连接成功后，在“Subscribe”输入框中输入测试主题，如：test/hoppscotch/status。

2、点击“Subscribe”按钮，观察下方“Subscriptions”列表是否新增该主题条目。

3、切换至“Publish”区域，在“Topic”栏再次输入相同主题，在“Payload”栏输入文本{"online":true}。

4、选择QoS等级为1（至少一次交付），勾选“Retain”若需持久化最新值。

5、点击“Publish”，立即查看“Messages”面板是否收到同主题回显消息。

五、调试遗嘱消息（Will Message）机制

该方法用于模拟客户端异常断开场景，验证Broker能否按预设策略发布遗嘱消息，保障物联网设备离线状态可感知。

1、在“Advanced Options”中展开“Will Message”配置区。

2、勾选“Set Will Message”启用遗嘱功能。

3、在“Will Topic”中输入遗嘱主题，如：devices/hoppscotch/status。

4、在“Will Payload”中填入遗嘱内容，例如：offline，QoS设为1，Retain勾选。

5、手动关闭连接或终止浏览器标签页，稍后检查订阅该主题的其他客户端是否收到遗嘱消息。