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

日期：2026.01.05

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

一、前期准备

• 硬件：ESP32-S3 开发板（带 WiFi）、USB 数据线、电脑（Windows 11）
  
• 软件环境：
  
  
  
  • 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++ 打开，在文件末尾添加以下两行配置：

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

复制代码

3.保存文件（若提示权限不足，右键编辑器选择 “以管理员身份运行” 后重试）
 
3、启动 Mosquitto 服务
1.按下 Win+R，输入 cmd 打开命令提示符，切换到安装目录：cd C:\Program Files\mosquitto.
2.执行启动命令（带日志输出，便于排查问题）

1. mosquitto.exe -c mosquitto.conf -v

复制代码

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

 

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！