综合档案管理系统温湿度管控实操：一步落地监测预警配置

实操前置准备

硬件准备

• DHT11数字温湿度传感器（适合普通档案库房使用）
• USB转TTL模块（CH340系列，驱动下载地址：https://www.wch-ic.com/downloads/CH341SER_EXE.html）
• 杜邦线3根（公对母）

软件准备

• Node.js 18.17.0（稳定版，下载地址：https://nodejs.org/dist/v18.17.0/node-v18.17.0-x64.msi）
• 现有综合档案管理系统API权限（需向系统管理员申请，获取接口地址与密钥）

核心配置步骤（零门槛直接操作）

第一步 硬件接线（关键：避免接线错误）

将DHT11的三个引脚与USB转TTL模块对应连接：VCC接USB转TTL的5V引脚、GND接模块GND引脚、DATA接模块RX引脚。接线完成后，把USB转TTL插入电脑USB口，打开Windows设备管理器，查看端口号（示例为COM3，需记录该端口号）。

第二步 Node.js项目初始化（直接复制命令）

按下Win+R输入cmd打开命令提示符，依次执行以下命令：

``` 新建项目文件夹 mkdir archive-humidity 进入项目目录 cd archive-humidity 初始化Node.js项目（一路回车确认） npm init -y 安装核心依赖库 npm install serialport node-dht-sensor axios ```

必须使用Node.js 18.17.0版本，高版本会导致串口依赖兼容性错误。

第三步 编写核心监测脚本（完整可直接复制）

在项目文件夹中新建index.js文件，写入以下代码，然后修改CONFIG段的3个关键参数：

``` const { SerialPort } = require('serialport'); const { ReadlineParser } = require('@serialport/parser-readline'); const axios = require('axios'); // 配置项：修改这3处即可，其他无需调整 const CONFIG = { portPath: 'COM3', // 替换为你设备管理器中的端口号 archiveApi: 'http://你的档案系统地址/api/humidity/report', // 替换为档案系统温湿度接口 apiKey: '档案系统管理员提供的密钥', // 替换为实际密钥 sensorType: 11, // DHT11对应11，DHT22对应22 uploadInterval: 60000, // 数据上传间隔，单位毫秒，60000=1分钟 threshold: { tempMin: 14, // 档案局规定档案存放最低温度 tempMax: 24, // 最高温度 humiMin: 45, // 最低湿度 humiMax: 60 // 最高湿度 } }; // 实际硬件部署时，注释下面的虚拟模拟代码，启用串口读取代码 // 虚拟模拟测试（无需硬件，先验证逻辑） setInterval(() => { const temp = (Math.random() 10) + 15; const humi = (Math.random() 20) + 40; uploadData(temp.toFixed(1), humi.toFixed(1)); }, CONFIG.uploadInterval); // 串口读取（实际硬件部署启用） / const port = new SerialPort({ path: CONFIG.portPath, baudRate: 9600 }); const parser = port.pipe(new ReadlineParser({ delimiter: '\r\n' })); parser.on('data', (data) => { const [temp, humi] = data.split(',').map(Number); if (!isNaN(temp) && !isNaN(humi)) uploadData(temp.toFixed(1), humi.toFixed(1)); }); / // 上传数据到档案系统 async function uploadData(temp, humi) { try { await axios.post(CONFIG.archiveApi, { temp: temp, humi: humi, time: new Date().toISOString() }, { headers: { Authorization: `Bearer ${CONFIG.apiKey}` } }); // 异常警报（可自行扩展对接企业微信、邮件） if (temp < CONFIG.threshold.tempMin || temp > CONFIG.threshold.tempMax || humi < CONFIG.threshold.humiMin || humi > CONFIG.threshold.humiMax) { console.log(`[ALERT] 温湿度异常：${temp}℃，${humi}%`); } } catch (err) { console.log('上传失败：', err.message); } } // 错误监听 process.on('uncaughtException', err => console.log('运行错误：', err.message)); ```

必须替换portPath、archiveApi、apiKey三个参数；测试时用虚拟代码，部署时注释虚拟代码、启用串口代码；阈值参数严格按照档案局标准设置。

第四步 后台运行（避免脚本关闭后停止）

在项目目录下执行以下命令，安装进程管理工具并启动：

``` 全局安装PM2（后台进程管理） npm install pm2 -g 启动监测脚本，命名为archive-humidity pm2 start index.js --name archive-humidity 设置Windows开机自动运行 pm2 startup pm2 save ```

Linux系统部署时，串口路径改为/dev/ttyUSB0，替换portPath即可，其他命令不变。

常见问题快速排查

1. 串口连接失败

检查接线是否接反、CH340驱动是否安装（从指定地址下载最新驱动）、设备管理器端口号是否与CONFIG中一致。

2. 数据上传失败

检查档案系统API是否开启、接口地址是否正确、API密钥是否有效、电脑网络是否能访问档案系统。

3. 传感器读数不稳定

缩短上传间隔（如改为30000=30秒），或更换精度更高的DHT22传感器（修改CONFIG中sensorType为22）。