一、标题

《专科零基础跑通物联网全链路: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-Demohttps://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 是我计划的第一个作品,接下来会:

  1. 买一块 ESP32 + DHT11(全套约 30 元),把模拟器换成真硬件——仓库里 device/esp32_mqtt_publish.ino 已经写好了
  2. 加上数据存库(SQLite/InfluxDB)和历史曲线查询
  3. 做一个微信小程序端查看数据

持续更新,欢迎关注。有问题的评论区见,看到都会回。

更多推荐