ESP32-S3 + Mosquitto MQTT 通信 调试日记

日期：2026.01.05

调试目标：实现 ESP32-S3 与本地 Mosquitto MQTT 服务器的稳定通信（订阅 + 发布）

一、前期准备

1. 硬件：ESP32-S3 开发板（带 WiFi）、USB 数据线、电脑（Windows 11）
2. 软件环境：
   • VS Code IDE（安装esp-idf-v5.5.1）
   • Mosquitto MQTT 服务器（win11本地安装，版本mosquitto-2.0.22-install-windows-x64.exe）
   • 通信猫在线代理服务器（URL="mqtt://mq.tongxinmao.com:18830")
   • MQTT.fx（MQTT 调试工具，用于验证服务器）
   • MQTT.fx（MQTT 调试工具，用于验证服务器）
    

二、第一步：搭建 Mosquitto 环境（踩坑开始）

操作：

1、下载 Mosquitto 安装包

1.访问 Mosquitto 官网下载页：https://mosquitto.org/download/

2.找到 Windows 版本，选择 mosquitto-2.0.22-install-windows-x64.exe（xx 为具体版本号，建议选择最新稳定版）

3.双击安装包，按默认向导完成安装（默认路径为 C:\Program Files\mosquitto）

 

2、修改配置文件（允许匿名访问与外部连接）

1.打开安装目录 C:\Program Files\mosquitto，找到配置文件 mosquitto.conf

2.用记事本或 Notepad++ 打开，在文件末尾添加以下两行配置：

listener 1883 0.0.0.0  # 监听1883端口，允许所有IP访问
allow_anonymous true   # 允许匿名登录（测试环境使用，生产环境需关闭并配置认证）

3.保存文件（若提示权限不足，右键编辑器选择 “以管理员身份运行” 后重试）

 

3、启动 Mosquitto 服务

1.按下 Win+R，输入 cmd 打开命令提示符，切换到安装目录：cd C:\Program Files\mosquitto.

2.执行启动命令（带日志输出，便于排查问题）

mosquitto.exe -c mosquitto.conf -v

3.若命令行显示 “Opening ipv4 listen socket on port 1883”，说明服务启动成功。

 

三、ESP32S3 VS code 环境下开发

1、安装esp-idf-v5.5.1

2、

 

2、例程选择"ESP-IDF-V5.5.1 ->mqtt  -> tcp".

 3.配置代理MQTT URL

1.点击左下边“SDK配置编译器(menuconfig)”

 

2.填写MQTT代理的URL链接

 

 

Broker URL 

mqtt://192.168.8.2:1883
或者
mqtt://mq.tongxinmao.com:18830

 

#define CONFIG_BROKER_URL "mqtt://192.168.8.2:1883"
esp_mqtt_client_config_t mqtt_cfg = {
        .broker.address.uri = CONFIG_BROKER_URL,
        .broker.address.port = 1883,
        .credentials.client_id = "mqtt-lh-22896",
    };

 

3.配置WIFI SSID和 Password.