如何将HiveMQ连接至MQTTX测试应用及SSL证书过期问题排查

排查与修复步骤 #

• 核实证书状态：登录HiveMQ控制台，确认集群SSL证书的实际过期时间，排查是否为证书真的过期（尤其是自签证书可能存在有效期设置过短的情况）。
• 替换过期证书：
  • 若使用HiveMQ自带演示证书，直接替换为新的有效证书（自签或CA签发均可）。
  • 修改HiveMQ的config.xml配置文件，更新SSL模块的证书路径，指向新的证书文件：

    <listener>
        <tls>
            <certificate-file>/path/to/new/valid-cert.pem</certificate-file>
            <private-key-file>/path/to/new/valid-key.pem</private-key-file>
        </tls>
    </listener>
    

• 同步MQTTX证书配置：将HiveMQ新生成的证书文件导入MQTTX的SSL设置，选择「自定义CA证书」模式，避免依赖系统默认证书库的旧缓存。
• 确认连接参数：确保使用HiveMQ配置的TLS端口（默认8883），连接URL格式应为mqtts://<集群地址>:8883，而非普通MQTT端口。
• 清理本地缓存：若MQTTX缓存了旧证书，尝试清空应用缓存或重装MQTTX，排除旧证书残留影响。

云服务场景提示 #

如果使用HiveMQ Cloud，直接在控制台重新生成TLS证书，更新后在MQTTX中重新导入新证书即可，无需手动修改服务器配置。

内容的提问来源于stack exchange，提问作者Timothy Chen