当前位置：首页 > news >正文

基于Node-RED与MySQL的物联网温湿度监测系统快速搭建指南

news 2026/6/4 14:51:16

1. 项目概述与核心价值

最近在做一个环境监测的小项目，核心需求是把部署在仓库里的几个无线温湿度传感器的数据，实时地采集上来并存到数据库里，方便后续做趋势分析和告警。市面上这类传感器很多，我最终选用了NCD的长距离无线温湿度传感器，搭配他们的USB无线网关。数据处理和存储这块，没有选择传统的写代码方式，而是用了Node-RED这个可视化工具，配合本地搭建的MySQL数据库。整个方案跑下来，从硬件上电到数据入库，不到半天就打通了，效率非常高。这篇文章，我就把这个从零开始的完整搭建过程，包括硬件连接、软件配置、数据流设计和几个关键的避坑点，详细地梳理一遍。无论你是物联网的初学者，还是想寻找一种快速原型验证方案的工程师，这套流程都能给你提供一个清晰、可复现的参考。

2. 硬件选型与核心组件解析

2.1 传感器与网关：为什么是NCD？

在这个项目中，我选择了NCD（National Control Devices）的Long Range IoT Temperature and Humidity Sensor及其配套的Wireless Mesh Modem。这个选择背后有几个关键的工程考量。

首先，通信距离与可靠性是核心。这款传感器标称在视距条件下可达28英里（约45公里）的传输距离，这得益于其采用的Sub-1GHz（通常是915MHz或868MHz，取决于地区）无线频段。与常见的2.4GHz WiFi或蓝牙相比，Sub-1GHz频率波长更长，绕射和穿透能力更强，在复杂室内环境（如多墙体的仓库、厂房）中表现更稳定，有效通信距离也远得多。这对于我的仓库部署场景至关重要，避免了需要部署大量中继节点的麻烦和成本。

其次，网络架构的灵活性。它支持无线Mesh网络，意味着传感器节点之间可以互相中继数据，自动寻找最优路径回传至网关。这不仅扩展了网络覆盖范围，还提升了系统的鲁棒性——单个节点故障不一定导致数据链路中断。网关设备通过USB接口与上位机（如我的笔记本电脑或树莓派）连接，将无线信号转换为串口数据，为软件层提供了标准的通信接口。

再者，功耗与续航直接决定了维护成本。传感器仅由两节AA电池供电，通过极致的低功耗设计（大部分时间处于深度睡眠，仅在设定的间隔唤醒并发送数据），宣称可实现长达10年的电池寿命。这意味着部署后几乎可以“一劳永逸”，无需频繁更换电池，对于大规模部署或难以触及的安装点来说，优势巨大。

最后，开放的通信协议是技术可控性的保障。NCD提供了完整的协议文档，这意味着我不必被绑定在特定的云平台或封闭生态里。数据可以自由地接入到Node-RED、Arduino、树莓派或任何能解析其串口数据的系统中，给了我最大的自主权去构建数据处理链路。

2.2 数据处理中枢：Node-RED的优势

为什么用Node-RED而不是自己写Python或Node.js脚本？核心原因在于开发效率与可视化调试。

Node-RED是一个基于Node.js的开源流编程工具，它用“节点”（Node）和“连线”（Flow）的方式来构建应用逻辑。对于物联网数据采集这种典型的“数据流”处理场景，它简直是“天作之合”。你不需要关心TCP/UDP连接管理、串口数据读取、字节流解析、JSON封装等底层细节，只需要从左侧的“节点面板”拖拽相应的功能节点（如串口输入、JSON解析、函数处理、数据库输出），然后用线把它们按逻辑连接起来即可。

例如，从网关读取到的原始字节流，通过一个“NCD无线网关”节点，就被自动解析成了包含MAC地址、温度、湿度、信号强度等字段的标准JSON对象。我只需要再拖一个“函数”节点，写两行JavaScript代码从这个JSON对象里提取出我需要的温度和湿度数值，再连接一个“MySQL”节点，配置好数据库连接和INSERT语句，数据存储的流水线就搭建完成了。整个过程如同搭积木，逻辑一目了然，修改和调试也极其方便——每个节点都可以实时查看通过它的数据内容。

此外，Node-RED内置了一个轻量级的Web服务器，这意味着我可以通过浏览器随时随地访问这个数据流控制台，进行部署、监控和修改，非常适合作为边缘计算场景下的控制中心。

2.3 数据存储：MySQL的经典角色

选择MySQL作为存储后端，是基于其普遍性、可靠性和工具生态。XAMPP是一个集成了Apache、MySQL、PHP和Perl的免费开源跨平台Web服务器解决方案包。在本项目中，我主要用它来快速在本机搭建一个MySQL数据库服务。

使用本地MySQL（通过XAMPP）的好处是：

零网络延迟与依赖：数据从Node-RED到数据库是本地回环通信，速度极快，且不依赖外网，保证了核心采集链路的稳定性。
完全的数据控制权：所有数据都保存在自己的机器上，无需担心云服务商的费用、政策变化或数据隐私问题。
丰富的管理工具：XAMPP自带的phpMyAdmin提供了一个非常友好的Web界面来创建数据库、数据表、执行SQL查询和查看数据，对于管理和验证数据入库结果非常方便。
易于迁移和扩展：当数据量增大或需要更正式的部署时，可以轻松地将这个本地MySQL迁移到一台专用的数据库服务器上，应用程序（Node-RED）只需修改连接地址即可，架构清晰。

3. 软件环境搭建与配置详解

3.1 本地数据库服务：XAMPP安装与初始化

第一步是建立数据存储的“仓库”。我选择从ApacheFriends官网下载适用于自己操作系统的XAMPP安装包。安装过程基本是“下一步”到底，但有一个关键选项需要注意：是否将Apache和MySQL安装为系统服务。

注意：如果勾选“安装为服务”，那么每次开机这两个服务都会自动启动。这对于需要长期运行数据库的服务器环境是好事。但如果你只是偶尔做开发测试，或者电脑内存资源紧张，建议不要勾选。你完全可以后续通过XAMPP控制面板手动启动它们，这样更灵活。

安装完成后，打开XAMPP控制面板。你会看到Apache和MySQL两个模块。分别点击它们后面的“Start”按钮。如果启动成功，按钮旁边的状态指示灯会变成绿色，并且PID（进程ID）位置会显示数字。常见的启动失败原因通常是端口冲突（如80端口被其他Web服务器占用，3306端口被其他MySQL实例占用）。如果遇到，可以在控制面板的“Config”里修改对应服务的端口号。

启动成功后，打开浏览器，访问http://localhost或http://127.0.0.1。如果看到XAMPP的欢迎页面，说明Apache服务运行正常。点击页面上的“phpMyAdmin”链接，或者直接访问http://localhost/phpMyAdmin，即可进入数据库管理界面。

3.2 数据库与表结构设计

在phpMyAdmin中，我们需要创建一个专用于本项目的数据库和表。

创建数据库：在左侧导航栏点击“新建”，在右侧输入数据库名称，例如iot_sensor_data。排序规则一般选择utf8mb4_general_ci（支持更完整的Unicode字符集，如Emoji）。点击“创建”。
设计数据表：新建数据库后，系统会提示你创建表。我们给表起个名字，比如temperature_humidity_log。
定义字段（列）：
- id(INT)：主键，唯一标识每条记录。勾选“A_I”（Auto Increment，自动递增），这样每次插入新记录时，id都会自动加1，无需手动指定。
- temperature(DECIMAL(5,2))：存储温度值。DECIMAL是精确小数类型，非常适合存储传感器读数。(5,2)表示总共5位数字，其中小数点后占2位（例如25.18）。这个精度对于±0.3°C的传感器足够了。
- humidity(DECIMAL(5,2))：存储湿度值，类型和精度同温度。
- created_at(TIMESTAMP)：记录数据插入的时间。在“默认”下拉框中，可以选择“CURRENT_TIMESTAMP”，这样每次插入数据时，如果不指定这个字段，数据库会自动填入当前时间。这对于数据追溯和分析非常有用。

最终的SQL建表语句（可以在phpMyAdmin的SQL标签页中执行）类似于：

CREATE TABLE `temperature_humidity_log` ( `id` int(11) NOT NULL AUTO_INCREMENT, `temperature` decimal(5,2) DEFAULT NULL, `humidity` decimal(5,2) DEFAULT NULL, `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.3 Node-RED核心节点安装与配置

Node-RED的安装非常简便。如果你已经安装了Node.js，只需在命令行中运行npm install -g --unsafe-perm node-red即可进行全局安装。安装完成后，在命令行输入node-red并回车，看到提示信息后，在浏览器中打开http://localhost:1880就能看到Node-RED的流编辑器界面了。

我们的项目需要两个额外的节点包：

ncd-red-wireless：这是与NCD无线网关和传感器通信的核心节点包。它提供了读取数据、配置设备等节点。
node-red-node-mysql：用于连接和操作MySQL数据库的节点。

安装方法有两种：

命令行安装（推荐）：在Node-RED的用户目录（通常是~/.node-red）下，运行命令npm install ncd-red-wireless node-red-node-mysql。然后重启Node-RED服务。
可视化安装：在Node-RED编辑器中，点击右上角菜单 -> “管理面板” -> “节点管理” -> “安装”标签页，然后分别搜索上述两个包名进行安装。

安装完成后，刷新编辑器页面，你会在左侧节点面板的“网络”或“功能”分类下找到新的节点，比如“wireless gateway”、“wireless in”和“mysql”。

4. Node-RED数据流设计与实现

4.1 构建数据采集主干流

数据流的逻辑是：串口网关节点读取数据 -> 过滤出特定传感器节点 -> 解析并格式化数据 -> 存入数据库。我们在Node-RED编辑器中一步步实现。

添加无线网关节点：从节点面板拖拽一个“wireless gateway”节点到画布上。双击它进行配置。关键步骤是设置串口设备。
配置串口连接：在节点的配置窗口中，点击“Serial Device”字段旁边的铅笔图标。在弹出的新窗口中，点击“Serial Port”旁边的放大镜图标，Node-RED会自动扫描可用的串口。你应该能看到一个类似于COM3(Windows) 或/dev/ttyUSB0(Linux/macOS) 的选项，这就是你的NCD USB网关所连接的端口。选中它，点击“添加”，然后“完成”。此时，网关节点上的红色三角警告标志应该会消失。
连接调试节点：为了验证数据是否到来，可以从面板拖一个“debug”节点放到画布上。双击它，将输出模式从“msg.payload”改为“完整消息对象”。然后用连线将“wireless gateway”节点的输出端连接到“debug”节点的输入端。点击右上角的红色“部署”按钮。
查看原始数据：部署后，看向编辑器右侧的“调试”标签页。如果传感器正在工作且连接正确，你会看到一条条JSON格式的消息快速刷出。点开任意一条，可以看到类似以下的结构：
```
{ “payload”: { “sensorType”: “Temperature/Humidity”, “macAddress”: “00:1B:...”， “temperatureC”: 23.45, “humidity”: 55.67, “rssi”: -45, “...”: “...” } }
```
这里包含了传感器的MAC地址、摄氏温度、相对湿度以及信号强度（RSSI）等所有信息。看到这个，说明硬件层和基础数据链路已经通了。

4.2 过滤与解析特定传感器数据

通常一个网关会接收多个传感器的数据。我们需要从中过滤出我们关心的那个传感器的数据。

添加无线传感器节点：从面板拖拽一个“wireless in”节点到画布。双击配置。
绑定特定传感器：在配置窗口中，“Serial Device”选择刚才网关节点使用的同一个串口设备。然后点击“MAC Address”旁边的放大镜图标。神奇的事情发生了：由于网关节点已经在运行并接收数据，它会自动发现网络中的传感器。列表中会显示出所有活跃传感器的MAC地址。选择你目标传感器的MAC地址，点击“完成”。这个节点现在就像一个过滤器，只允许指定MAC地址的数据包通过。
数据格式化处理：从“wireless in”节点输出的数据，其msg.payload已经是一个包含温湿度值的对象了。但为了更清晰地存入数据库，我们通常需要做一个简单的提取和格式化。拖一个“function”节点放到“wireless in”节点后面。

编写处理函数：双击“function”节点，在代码框中输入：

// 从上游节点的msg.payload中提取所需字段 var temp = msg.payload.temperatureC; // 摄氏温度 var humi = msg.payload.humidity; // 相对湿度 // 构建一个新的payload对象，准备传递给MySQL节点 // 对象的属性名需要与数据库表的列名对应 msg.payload = { temperature: temp, humidity: humi // created_at字段由数据库自动生成，这里不需要传递 }; // 返回处理后的消息，继续向下游流动 return msg;

这段代码的作用是将嵌套的传感器数据“拍平”，只取出温度和湿度两个数值，并封装成一个新的对象。这个新对象的键（temperature,humidity）必须与我们之前创建的数据库表的列名完全一致，这样MySQL节点才能正确匹配插入。

4.3 配置数据库连接与写入

这是将数据持久化的最后一步。

添加MySQL节点：从面板拖拽一个“mysql”节点到画布，放在“function”节点后面。
配置数据库连接：双击MySQL节点进行配置。首先需要创建一个数据库连接配置。点击“数据库”字段旁边的铅笔图标（添加新配置）。
- 服务器：填写localhost或127.0.0.1。
- 端口：默认是3306。
- 用户：XAMPP默认的MySQL超级用户是root。
- 密码：XAMPP默认安装下，root用户密码为空。（重要：在生产环境中，务必为root设置强密码，并创建具有最小权限的专用用户！）
- 数据库：填写我们之前创建的数据库名，例如iot_sensor_data。填写后，可以点击“测试连接”按钮，如果显示成功，说明配置正确。然后点击“更新”，再点击“完成”。
配置SQL操作：回到MySQL节点的配置主界面，现在“数据库”下拉框里应该有你刚创建的配置，选中它。
- 操作：选择“插入 - 插入一条记录”。
- 表：输入表名temperature_humidity_log。
- 字段名称：这里需要告诉节点，将msg.payload对象中的哪个属性插入到表的哪个列。由于我们之前在function节点里构造的msg.payload对象属性名（temperature,humidity）正好与表列名一致，所以这里可以留空，Node-RED会自动进行映射。这是一种简便做法。
- 更稳妥的做法是显式指定��射关系。你可以点击“字段名称”旁边的扳手图标，手动添加两个映射：temperature->temperature,humidity->humidity。
完成连线与部署：用连线将“function”节点的输出端连接到“mysql”节点的输入端。最后，点击右上角的“部署”按钮。如果一切正常，MySQL节点左下角会显示一个绿色的“已连接”状态。当有传感器数据流过时，节点可能会短暂显示“处理中”，然后恢复。

5. 数据验证、问题排查与进阶优化

5.1 验证数据是否成功入库

部署流之后，如何确认数据真的写进了数据库？有几种方法：

使用phpMyAdmin实时查看：在浏览器中打开http://localhost/phpMyAdmin，导航到iot_sensor_data数据库下的temperature_humidity_log表，点击“浏览”标签页。你应该能看到新的数据行随着传感器上报周期不断插入，created_at字段会自动记录插入时间。
在Node-RED中添加调试反馈：可以在“mysql”节点后面再连接一个“debug”节点，并将其配置为输出“msg.payload”（即插入操作的结果）。成功插入后，通常会返回一个包含affectedRows等信息的对象。或者，连接一个“change”节点，将msg.payload设置为固定的成功提示信息，再连到一个“debug”节点，这样在调试窗口就能直观地看到每次插入成功的日志。
添加错误处理：从“mysql”节点引出的连线，除了默认的输出端口（成功），还有一个灰色的输出端口（代表错误）。你可以从这个端口连出一个“debug”节点，专门用来捕获和显示数据库操作失败的错误信息（如连接失败、SQL语法错误等），这对于排查问题至关重要。

5.2 常见问题与解决方案实录

在实际搭建过程中，我遇到了几个典型问题，这里把排查思路和解决方法记录下来：

问题一：Node-RED中找不到串口，或者网关节点显示“未连接”。

排查：首先确认USB网关已正确插入电脑，并且传感器已上电。然后在操作系统的设备管理器中查看端口，确认网关对应的COM口（如COM3）是否存在且无冲突。
解决：在Node-RED的网关节点配置中，手动输入正确的端口号（如COM3）。在Linux/macOS下，可能需要将当前用户添加到dialout组以获得串口访问权限：sudo usermod -a -G dialout $USER，然后注销重新登录。

问题二：调试窗口能看到数据，但MySQL节点报错或数据未插入。

排查：检查MySQL节点配置中的数据库名、表名是否拼写正确（区分大小写）。检查msg.payload对象的属性名是否与表列名完全一致。可以在function节点后加一个debug节点，查看其输出的msg.payload对象结构是否符合预期。
解决：确保XAMPP中的MySQL服务正在运行。在phpMyAdmin中手动执行一条简单的INSERT语句，测试数据库连接和权限。例如：INSERT INTO temperature_humidity_log (temperature, humidity) VALUES (25.5, 60.0);。如果手动执行成功，但Node-RED失败，问题大概率出在数据格式映射上。

问题三：数据插入频率过高，或存在重复、无效数据。

分析：传感器可能按固定频率（如每10秒）发送数据，但某些情况下（如信号波动）可能导致数据包重复或瞬间产生无效值（如湿度超过100%）。
解决：在Node-RED流中引入控制逻辑。
- 限流：在“wireless in”节点后添加一个“delay”节点，将其设置为“速率限制”模式，例如“每10秒只允许1条消息通过”，这样可以平滑数据流，降低数据库压力。
- 数据清洗：在“function”节点中增加数据有效性校验逻辑。
```
var temp = msg.payload.temperatureC; var humi = msg.payload.humidity; // 定义合理范围 if (temp >= -40 && temp <= 85 && humi >= 0 && humi <= 100) { msg.payload = {temperature: temp, humidity: humi}; return msg; // 返回有效数据 } else { node.warn(“收到异常数据，已丢弃: “, msg.payload); return null; // 返回null，消息流在此终止 }
```
- 去重：可以利用传感器数据中的序列号或时间戳，在function节点中实现简单的缓存比对，丢弃短时间内MAC地址、温度、湿度完全相同的记录。

问题四：如何实现超阈值报警？这是物联网监测的常见需求。实现思路是在数据存入数据库前或后，进行逻辑判断。

在“function”节点处理数据后，分出两条流：一条流向MySQL节点进行存储，另一条流向一个判断节点。
添加一个“switch”节点（或另一个“function”节点），设置判断条件，例如msg.payload.temperature > 30。
如果条件为真（温度超过30度），则将消息流向一个“email”节点（需安装node-red-node-email）或“telegram”节点等，发送报警通知。同时，也可以流向一个“dashboard”节点的仪表盘或图表，进行高亮显示。

5.3 系统优化与扩展思考

当这个基础流程稳定运行后，可以考虑以下几个方向的优化和扩展：

数据持久化与备份：目前数据存在本地电脑的MySQL中。可以考虑定期（如每天）使用MySQL的mysqldump命令自动备份数据库文件。或者，配置Node-RED将数据同时写入一个本地的SQLite文件作为缓存，再通过另一个流定时将数据同步到云数据库（如阿里云RDS、腾讯云CDB），实现异地容灾。
可视化监控面板：安装node-red-dashboard节点包，可以轻松创建包含图表、仪表、开关的实时Web监控面板。你可以拖拽一个“chart”节点，将其数据源连接到温湿度数据流，就能在浏览器中看到一个实时更新的温度/湿度曲线图，非常直观。
历史数据查询API：Node-RED不仅可以处理输入流，还可以响应HTTP请求。你可以添加一个“http in”节点监听GET请求（如/api/temperature），后面连接一个“function”节点编写查询数据库的逻辑（使用另一个配置了“查询”操作的MySQL节点），最后通过“http response”节点将查询结果以JSON格式返回。这样，你就为自己的传感器数据创建了一个简单的RESTful API，可供其他应用程序调用。
设备管理与配置：ncd-red-wireless节点包中的“wireless config”节点允许你通过Node-RED流动态修改传感器的上报间隔、无线信道等参数。你可以创建一个带密码验证的HTTP接口，当需要调整传感器行为时，通过Web界面触发配置指令的下发，实现远程设备管理。

整个项目搭建下来，最深的体会是，Node-RED这种可视化编程工具极大地降低了物联网数据接入和处理的复杂度，让开发者能更专注于业务逻辑而非通信细节。而将数据落地到MySQL这样的关系型数据库，则为后续任何复杂的数据分析、报表生成提供了坚实的基础。这套组合对于快速原型验证和小型物联网应用部署来说，效率和可靠性都非常出色。

查看全文

http://www.jsqmd.com/news/949260/