ESP32 IDF MQTT5示例连接HiveMQ Cloud问题求助

背景 #

未修改ESP-IDF的MQTT5示例项目时，可成功连接Mosquitto，日志如下：

I (47716) mqtt5_example: Other event id:7 I (47726) main_task: Returned from app_main() I (49036) mqtt5_example: MQTT_EVENT_CONNECTED

已通过Python Paho MQTT5 TLS测试程序成功连接HiveMQ Cloud，确认Broker端无问题，但修改ESP-IDF代码后无法正常连接，以下是尝试的配置及对应错误：

尝试1：直接替换URI为HiveMQ域名 #

修改代码：

.broker.address.uri = "d72b0b51da08402e86d06db5db25f244.s1.eu.hivemq.cloud",

日志报错：

E (27296) mqtt_client: Error parse uri = d72b0b51da08402e86d06db5db25f244.s1.eu.hivemq.cloud

尝试2：添加mqtt://前缀 #

修改代码：

.broker.address.uri = "mqtt://d72b0b51da08402e86d06db5db25f244.s1.eu.hivemq.cloud",

日志报错连接超时：

E (39766) esp-tls: [sock=54] select() timeout
E (39766) transport_base: Failed to open a new connection: 32774
E (39766) mqtt_client: Error transport connect

尝试3：注释URI，手动配置主机、端口和TCP传输 #

修改代码：

// .broker.address.uri = CONFIG_BROKER_URL,
.broker.address.hostname = "d72b0b51da08402e86d06db5db25f244.s1.eu.hivemq.cloud",
.broker.address.port = 8883,
.broker.address.transport = MQTT_TRANSPORT_OVER_TCP,

日志报错传输读取错误：

E (21096) mqtt_client: esp_mqtt_handle_transport_read_error: transport_read(): EOF
E (21096) mqtt_client: esp_mqtt_handle_transport_read_error: transport_read() error: errno=128

尝试4：Mosquitto测试冲突配置 #

用以下配置连接Mosquitto：

.broker.address.uri = CONFIG_BROKER_URL,
.broker.address.port = 8883,
.broker.address.transport = MQTT_TRANSPORT_OVER_TCP,

日志提示：

W (30676) mqtt_client: Transport config set, but overridden by scheme
from URI: transport = 1, uri scheme = mqtt E (30686) mqtt5_client: Client was not initialized

HiveMQ Cloud默认强制要求TLS加密连接，以下是两种可行的正确配置方式：

方式1：使用mqtts:// URI #

直接配置带TLS协议的URI，端口8883为MQTT over TLS的默认端口，可省略：

.broker.address.uri = "mqtts://d72b0b51da08402e86d06db5db25f244.s1.eu.hivemq.cloud:8883",
// 补充身份验证信息
.credentials.username = "你的HiveMQ Cloud用户名",
.credentials.password = "你的HiveMQ Cloud密码",

方式2：手动配置主机、端口及SSL传输 #

注释URI配置，明确指定SSL传输方式，并添加身份验证：

// .broker.address.uri = CONFIG_BROKER_URL,
.broker.address.hostname = "d72b0b51da08402e86d06db5db25f244.s1.eu.hivemq.cloud",
.broker.address.port = 8883,
.broker.address.transport = MQTT_TRANSPORT_OVER_SSL,
// 身份验证
.credentials.username = "你的HiveMQ Cloud用户名",
.credentials.password = "你的HiveMQ Cloud密码",
// 证书验证（HiveMQ Cloud使用公开可信证书，无需自定义证书）
.broker.verification.certificate = NULL,
.broker.verification.skip_cert_common_name_check = false,

关键注意事项 #

1. 必须配置用户名密码：HiveMQ Cloud不允许匿名连接，需使用你注册账号时设置的MQTT凭证。
2. 校准设备系统时间：TLS证书验证依赖正确的系统时间，需通过NTP服务同步设备时间，否则会导致证书验证失败。
3. 避免配置冲突：不要同时设置URI和手动主机/端口参数，两者会互相覆盖导致初始化失败。

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