《专科零基础跑通物联网全链路:ESP32+MQTT+Flask 实时监控看板(含4个新手必踩的坑)》
一、标题
《专科零基础跑通物联网全链路:ESP32+MQTT+Flask 实时监控看板(含4个新手必踩的坑)》
二、正文
正文开始 ↓↓↓
专科零基础跑通物联网全链路:ESP32+MQTT+Flask 实时监控看板(含4个新手必踩的坑)
0. 前言:这篇文章适合谁
我是物联网应用技术专业的生,毕业季想做一个能写进简历的物联网小项目。网上教程要么需要先买开发板,要么代码跑不起来,我花了一个晚上,从零跑通了"设备 → MQTT → 后端 → 浏览器实时曲线"的完整链路,全程不需要买任何硬件。
先看最终效果:
【配图位1:screenshots/效果图.jpg —— 浏览器里实时跳动的温度曲线】

温度曲线每 3 秒自动跳动一次,左上角设备卡片实时刷新。
本项目用到的技术(都是入门级):
| 技术 | 作用 | 难度 |
| Python | 写模拟器和后端 | ⭐ |
| paho-mqtt | 收发 MQTT 消息 | ⭐ |
| Flask | Web 服务 | ⭐⭐ |
| flask-socketio | 后端数据实时推送到浏览器 | ⭐⭐ |
| ECharts | 画实时曲线图 | ⭐(现成代码) |
| Git / GitHub | 代码托管 | ⭐ |
完整代码已开源:**https://github.com/LJX-Y/IoT-Application-Demo
https://github.com/LJX-Y/IoT-Application-Demo** (觉得这个有用点个Star,这是对我最大的鼓励)
1. 先搞懂原理:数据是怎么流动的
一句话:设备发消息 → MQTT 服务器转发 → 我的后端收下 → 浏览器实时画出来。
┌──────────────┐ 发布 ┌─────────────────┐ 订阅 ┌──────────────┐
│ ESP32 模拟器 │ ───────→ │ MQTT Broker │ ───────→ │ Flask 后端 │
│ (Python脚本) │ │ broker.emqx.io │ │ (订阅+存储) │
└──────────────┘ │ (免费公共服务器) │ └──────┬───────┘
└─────────────────┘ │ WebSocket
┌────────▼───────┐
│ 浏览器页面 │
│ (ECharts曲线图) │
└────────────────┘
关键知识点:
- MQTT 是物联网最常用的通信协议,就像"微信群":设备往群里发消息(发布),服务器把消息转给所有关注这个群的人(订阅)
- Broker 就是那个"群服务器",我们用的是 EMQX 提供的免费公共 Broker(
broker.emqx.io),不用自己搭
- WebSocket 解决"后端一有新数据,浏览器立刻刷新"的问题,不用手动 F5
2. 环境准备(10分钟)
只需要装两样东西:
① Python(3.8 以上):官网下载,安装时务必勾选 Add Python to PATH
② 依赖库:打开 cmd,进入项目目录后执行:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
-i后面是清华镜像源,下载速度快很多。
requirements.txt 内容(就4个):
paho-mqtt==1.6.1
flask==2.3.3
flask-socketio==5.3.6
python-dotenv==1.0.0
【pip install 成功的截图 —— "Successfully installed ..." 】
3. 核心代码讲解
3.1 设备模拟器:假装我有一块 ESP32
买开发板要等快递,先用 Python 模拟一块"每 3 秒上报一次温湿度"的设备。以后买了真板子,把这段换成 Arduino 程序即可,后端代码一行都不用改——这就是分层的的好处。
# device/publisher_simulator.py(简化版,完整版见GitHub)
import json, random, time
import paho.mqtt.client as mqtt
BROKER = "broker.emqx.io" # 免费公共MQTT服务器
TOPIC = "iot/devices/esp32-sim-001/data"
client = mqtt.Client(client_id="esp32-sim-001")
client.connect(BROKER, 1883, 60)
client.loop_start()
while True:
payload = {
"temperature": round(random.uniform(20, 30), 1),
"humidity": round(random.uniform(40, 70), 1),
}
client.publish(TOPIC, json.dumps(payload))
print(f"上报: {payload}")
time.sleep(3)
划重点:iot/devices/esp32-sim-001/data 这种斜杠分层写法叫 MQTT 主题(Topic),+ 是通配符,后端订阅 iot/devices/+/data 就能收到所有设备的数据——加一块设备,代码零修改。
3.2 后端:订阅消息 + Web推送
# backend/mqtt_subscriber.py(简化版)
def on_message(client, userdata, msg):
payload = json.loads(msg.payload.decode())
data = {
"device_id": msg.topic.split("/")[2],
"timestamp": datetime.now().isoformat(),
**payload
}
data_queue.put(data) # 扔进队列,Web服务从这里取
client.subscribe("iot/devices/+/data") # 通配符订阅所有设备
Flask 那边开一个后台线程,不停地从队列里取数据,用 WebSocket 推给浏览器(完整代码见 GitHub 的 backend/app.py)。
3.3 前端:ECharts 实时曲线
浏览器端监听 WebSocket 消息,每来一条新数据就追加到曲线:
socket.on('device_data', (data) => {
deviceData[devId].push([data.timestamp, data.temperature]);
chart.setOption({ series: [{ data: deviceData[devId].slice(-20) }] });
});
4. 运行
开两个 cmd 窗口(都在项目目录下):
# 窗口1:启动Web服务
python backend\app.py
# 窗口2:启动模拟器
python device\publisher_simulator.py
浏览器打开 http://localhost:5000 —— 曲线开始跳动,就成了!
【配图位2: 后端窗口收到数据的画面】
【配图位3:模拟器窗口上报数据的画面】
5. 我踩过的4个坑(本文精华,先看这节也行)
坑1:cmd 切不过去目录
cd E:\xxx ❌ 提示符纹丝不动
cd /d E:\xxx ✅ 一次成功
原因:cmd 的 cd 默认不跨盘符,/d 参数表示"连盘符一起切"。另外 cmd 路径要用反斜杠 \,别用 /。
隐藏技巧:在文件资源管理器打开项目文件夹,地址栏直接输入
cmd回车,黑窗口打开时就站在正确目录里,根本不用 cd。
坑2:pip 报 "No such file or directory: 'requirements.txt'"
原因:不在项目目录里执行了 pip。先 dir 看一眼当前文件夹里有没有 requirements.txt,没有就是走错了。
口诀:dir 里没有 requirements.txt = 站错地方了。
坑3:批处理文件双击乱码
我图省事写了两个 .bat 启动脚本,双击后满屏乱码 + 'xxx' 不是内部或外部命令。
原因:bat 文件是 LF 换行(Linux 格式),而 Windows cmd 只认 CRLF;再加上文件里有中文(编码问题),两个坑叠加。
解决:bat 文件纯英文内容 + CRLF 换行,一劳永逸。
坑4:git push 连不上 GitHub(443超时)
Failed to connect to github.com port 443 after 21150 ms
原因:国内访问 GitHub 偶发抽风,这个 21 秒超时是典型的临时阻断。
解决:直接重试;不行就开手机热点。另外 push 报 Author identity unknown 是没设身份:
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
push 时的"密码"必须填 Personal Access Token(GitHub → Settings → Developer settings → Personal access tokens 生成),账号密码早就不能用了。
6. 下一步计划
这个 Demo 是我计划的第一个作品,接下来会:
- 买一块 ESP32 + DHT11(全套约 30 元),把模拟器换成真硬件——仓库里
device/esp32_mqtt_publish.ino已经写好了 - 加上数据存库(SQLite/InfluxDB)和历史曲线查询
- 做一个微信小程序端查看数据
持续更新,欢迎关注。有问题的评论区见,看到都会回。
更多推荐


所有评论(0)