一、前期准备硬件ESP32-S3 开发板带 WiFi、USB 数据线、电脑Windows 11软件环境VS Code IDE安装esp-idf-v5.5.1Mosquitto MQTT 服务器win11本地安装版本mosquitto-2.0.22-install-windows-x64.exe通信猫在线代理服务器URLmqtt://mq.tongxinmao.com:18830)MQTT.fxMQTT 调试工具用于验证服务器MQTT.fxMQTT 调试工具用于验证服务器二、第一步搭建 Mosquitto 环境踩坑开始操作1、下载 Mosquitto 安装包1.访问 Mosquitto 官2.找到 Windows 版本选择mosquitto-2.0.22-install-windows-x64.exexx 为具体版本号建议选择最新稳定版3.双击安装包按默认向导完成安装默认路径为 C:\Program Files\mosquitto2、修改配置文件允许匿名访问与外部连接1.打开安装目录 C:\Program Files\mosquitto找到配置文件mosquitto.conf2.用记事本或 Notepad 打开在文件末尾添加以下两行配置listener 1883 0.0.0.0 # 监听1883端口允许所有IP访问 allow_anonymous true # 允许匿名登录测试环境使用生产环境需关闭并配置认证3.保存文件若提示权限不足右键编辑器选择 “以管理员身份运行” 后重试3、启动 Mosquitto 服务1.按下 WinR输入 cmd 打开命令提示符切换到安装目录cd C:\Program Files\mosquitto.2.执行启动命令带日志输出便于排查问题mosquitto.exe -c mosquitto.conf -v3.若命令行显示 “Opening ipv4 listen socket on port 1883”说明服务启动成功。三、ESP32S3 VS code 环境下开发1、安装esp-idf-v5.5.12、2、例程选择ESP-IDF-V5.5.1 -mqtt - tcp.3.配置代理MQTT URL1.点击左下边“SDK配置编译器(menuconfig)”2.填写MQTT代理的URL链接Broker URLmqtt://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.