ESP32 + MQTT + Node-RED：从传感器到网页看板的完整数据链路

ESP32 + MQTT + Node-RED：从传感器到网页看板的完整数据链路



很多人做到 ESP32 项目时，只能把温湿度打印在串口里。
但真正可扩展的物联网系统，应该让数据进入消息系统、流程引擎和网页看板。
本文用一个简化项目，展示 ESP32、MQTT 和 Node-RED 是怎样连起来的。
做 ESP32 项目时，很多人能把温湿度打印到串口，却不知道如何把它变成可查看、可扩展、可用于后续控制的数据系统。一个可继续扩展的智慧温室，数据链路应当清晰：


```text
传感器 → ESP32 → MQTT Broker → Node-RED → Dashboard / 数据库 / 控制逻辑
```

各组件只做一件事：ESP32 负责现场采集；MQTT 负责消息传递；Node-RED 负责解析、展示和后续业务处理。这样以后增加区域、报警或数据库时，不需要把所有逻辑重新塞进单片机。

## 一条统一的遥测消息

设备发送的数据应尽量保持字段稳定，例如：

```json
{
  "device_id": "esp32-zone1",
  "temperature": 25.6,
  "humidity": 61.2,
  "soil_moisture": 42
}
```

Node-RED 接到消息后，再把温度、湿度和土壤湿度分别交给不同的页面组件。字段名从设备端到后续数据记录最好保持一致，后期排错会轻松很多。

## 最小验证流程

Node-RED 的第一版流程不需要很复杂：

```text
mqtt in → json → debug → ui_gauge
```

先在 `debug` 节点确认数据确实进入 Node-RED，再连 Dashboard。出现“页面没数据”时，不要先怀疑 UI；按下面路径依次检查：

```text
ESP32 串口 → MQTT Topic → Node-RED Debug → Dashboard 数据格式
```



## 一个常见误区

不要让 ESP32 直接承担网页、数据库和复杂业务规则。设备端应该保持简单、稳定；Node-RED 才是适合迭代规则和界面的地方。以后即使 ESP32 换成 PLC，Node-RED 后面的数据处理思路仍可以复用。

## 本文做到什么，还缺什么

本文只展示“数据如何进 Node-RED 并显示”的核心链路。完整项目还需要历史数据、自动灌溉保护、离线判断、报警和可复制部署。

> 本文是《Node-RED 智慧温室实战：ESP32 + MQTT + MySQL + Docker自动灌溉》中的一个知识点。完整课程包含 ESP32 固件、MQTT 通信、Node-RED Flow、MySQL 数据库、Dashboard、自动灌溉、报警和 Docker 部署。
课程入口：完整课程正在整理中，后续将发布课程入口。