手把手教你用ESP32和DHT11搭建一个简易的温湿度监测站（附MQTT配置避坑指南）

张

张建站

2026/5/20 16:08:15

10分钟阅读

手把手教你用ESP32和DHT11搭建一个简易的温湿度监测站（附MQTT配置避坑指南）

从零构建ESP32DHT11物联网温湿度监测系统硬件选型到云端可视化的完整指南在智能家居和工业物联网快速发展的今天环境监测已成为许多应用场景的基础需求。无论是想要监控家中的温湿度变化还是需要对小型工作坊的环境参数进行记录一个稳定可靠的监测系统都至关重要。ESP32微控制器凭借其强大的无线连接能力和丰富的接口资源搭配经济实惠的DHT11温湿度传感器构成了性价比极高的硬件组合。本文将带你从硬件组装开始逐步完成固件开发、MQTT通信配置最终实现数据的云端可视化展示打造一个完整的物联网监测解决方案。1. 硬件选型与准备1.1 核心组件介绍ESP32开发板的选择直接影响整个系统的稳定性和扩展性。目前市面上常见的型号包括ESP32-WROOM-32基础版本性价比较高ESP32-WROVER增加了PSRAM适合需要大内存的应用ESP32-S系列新一代产品功耗更低对于温湿度监测项目推荐使用ESP32-WROOM-32它具备以下优势双核240MHz处理器性能充足集成Wi-Fi和蓝牙4.2丰富的GPIO接口低功耗模式支持DHT11传感器是一款经典的温湿度复合传感器其主要特性包括参数规格温度测量范围0-50°C (±2°C精度)湿度测量范围20-90%RH (±5%精度)采样周期≥1秒接口类型单总线数字信号虽然精度不及更高级的DHT22或SHT3x系列但对于大多数家庭和小型场所的监测需求已经足够。1.2 配件与工具清单除了核心组件外还需要准备以下物品Micro USB数据线用于供电和编程面包板及跳线方便原型搭建5V电源适配器可选用于长期供电10kΩ上拉电阻部分DHT11模块已集成提示购买DHT11时建议选择带有PCB板的模块版本它通常已经集成了必要的上拉电阻使用更加方便。2. 硬件连接与测试2.1 电路连接指南ESP32与DHT11的连接非常简单只需三根线VCC连接ESP32的5V引脚GND连接ESP32的任一GND引脚DATA连接ESP32的GPIO引脚推荐使用GPIO4、GPIO5等具体接线示例// ESP32引脚定义 #define DHTPIN 5 // 数据线连接的GPIO引脚 // 接线对应关系 // DHT11 VCC - ESP32 5V // DHT11 GND - ESP32 GND // DHT11 DATA - ESP32 GPIO52.2 基础功能测试在搭建完整系统前建议先进行传感器基础测试。使用Arduino IDE编写简单的测试程序#include DHTesp.h DHTesp dht; int dhtPin 5; void setup() { Serial.begin(115200); dht.setup(dhtPin, DHTesp::DHT11); } void loop() { TempAndHumidity data dht.getTempAndHumidity(); Serial.printf(温度: %.1f°C, 湿度: %.1f%%\n, data.temperature, data.humidity); delay(2000); }上传程序后打开串口监视器应能看到类似输出温度: 25.3°C, 湿度: 52.0% 温度: 25.4°C, 湿度: 52.1%如果读取失败检查接线是否正确特别是DATA线是否接触良好。3. 物联网通信架构设计3.1 MQTT协议简介MQTT(Message Queuing Telemetry Transport)是一种轻量级的发布/订阅模式消息协议特别适合物联网应用。其核心概念包括Broker消息代理服务器负责接收和分发消息Topic消息的主题用于分类和过滤Publisher消息发布者Subscriber消息订阅者在温湿度监测系统中ESP32作为Publisher将数据发送到指定Topic而任何订阅了该Topic的设备或应用都能接收到这些数据。3.2 MQTT服务器选择对于个人和小型项目可以使用免费的公共MQTT Broker服务提供商地址端口认证EMQX Publicbroker.emqx.io1883无Mosquittotest.mosquitto.org1883无HiveMQbroker.hivemq.com1883无注意公共Broker适合测试和学习生产环境建议使用自建或商业服务确保数据安全和稳定性。3.3 WiFi连接优化稳定的网络连接是物联网系统的关键。ESP32的WiFi连接可以通过以下方式优化#include WiFi.h const char* ssid your_SSID; const char* password your_PASSWORD; void initWiFi() { WiFi.mode(WIFI_STA); WiFi.begin(ssid, password); Serial.print(Connecting to WiFi...); int retries 0; while (WiFi.status() ! WL_CONNECTED retries 15) { delay(500); Serial.print(.); retries; } if (WiFi.status() WL_CONNECTED) { Serial.println(\nConnected: WiFi.localIP()); } else { Serial.println(\nConnection failed); // 可添加重启或进入深度睡眠逻辑 } }增加重试机制和超时判断可以避免程序卡死在连接过程中。4. 完整系统实现4.1 数据上传实现结合DHT11读取和MQTT上传的完整代码框架#include WiFi.h #include PubSubClient.h #include DHTesp.h // WiFi配置 const char* ssid your_SSID; const char* password your_PASSWORD; // MQTT配置 const char* mqtt_broker broker.emqx.io; const char* topic home/sensor/dht11; const int mqtt_port 1883; // 传感器配置 const int dhtPin 5; DHTesp dht; WiFiClient espClient; PubSubClient client(espClient); void reconnect() { while (!client.connected()) { String clientId ESP32Client- String(random(0xffff), HEX); if (client.connect(clientId.c_str())) { Serial.println(MQTT connected); } else { Serial.print(Failed, rc); Serial.print(client.state()); Serial.println( retrying in 5s); delay(5000); } } } void setup() { Serial.begin(115200); dht.setup(dhtPin, DHTesp::DHT11); initWiFi(); client.setServer(mqtt_broker, mqtt_port); } void loop() { if (!client.connected()) { reconnect(); } client.loop(); static unsigned long lastMsg 0; if (millis() - lastMsg 10000) { // 每10秒发送一次 lastMsg millis(); TempAndHumidity data dht.getTempAndHumidity(); if (!isnan(data.temperature) !isnan(data.humidity)) { String payload {\temp\: String(data.temperature,1) ,\hum\: String(data.humidity,1) }; client.publish(topic, payload.c_str()); } } }4.2 数据可视化方案收集到的数据可以通过多种方式展示MQTT客户端工具如MQTTX、MQTT.fx等实时查看数据流Node-RED搭建简单的可视化仪表盘InfluxDBGrafana专业级的时间序列数据存储和展示自定义Web应用通过WebSocket接收并展示数据以Node-RED为例基本流程包括添加MQTT输入节点配置连接参数添加JSON解析节点处理传感器数据添加仪表盘图表节点展示趋势变化添加文本显示节点显示当前数值5. 进阶优化与问题排查5.1 常见问题解决方案问题1DHT11读取失败或返回NaN检查电源电压是否稳定应在3.3V-5V之间确认DATA线连接正确并启用了上拉电阻增加读取间隔DHT11需要至少1秒的采样周期问题2MQTT连接不稳定检查WiFi信号强度RSSI应大于-70dBm适当增加MQTT心跳间隔默认15秒可能太短实现断线自动重连机制问题3数据上传频率过高导致服务器拒绝限制上传频率建议不低于10秒间隔实现本地缓存网络恢复后批量上传考虑使用更高效的二进制协议而非JSON5.2 低功耗优化技巧对于电池供电的应用可以通过以下方式延长续航启用ESP32的深度睡眠模式#define uS_TO_S_FACTOR 1000000 // 微秒到秒转换因子 #define TIME_TO_SLEEP 300 // 休眠时间(秒) void setup() { esp_sleep_enable_timer_wakeup(TIME_TO_SLEEP * uS_TO_S_FACTOR); esp_deep_sleep_start(); }仅在测量和上传时唤醒WiFi模块降低CPU频率当性能要求不高时使用单次WiFi连接完成多项操作5.3 数据安全考虑虽然公共Broker方便测试但生产环境应考虑使用TLS加密通信MQTT over SSL实现客户端证书认证设置复杂的Topic名称避免冲突定期更换认证凭证一个简单的认证增强示例// 更安全的连接方式 bool connectMQTT() { String clientId ESP32- String(random(0xffff), HEX); if (client.connect(clientId.c_str(), secure_username, ComplexPssw0rd2023)) { return true; } return false; }6. 项目扩展思路基础系统搭建完成后可以考虑以下扩展方向多传感器融合增加光照、空气质量等传感器本地显示添加OLED屏幕实时显示数据报警功能当温湿度超出阈值时触发通知历史数据存储集成SD卡或Flash存储模块远程控制通过MQTT下发控制指令例如添加SSD1306 OLED显示的代码片段#include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, -1); void setup() { display.begin(SSD1306_SWITCHCAPVCC, 0x3C); display.clearDisplay(); } void updateDisplay(float temp, float hum) { display.clearDisplay(); display.setTextSize(1); display.setTextColor(WHITE); display.setCursor(0,0); display.println(Environment Monitor); display.setTextSize(2); display.setCursor(0,20); display.print(Temp: ); display.print(temp,1); display.println(C); display.setCursor(0,40); display.print(Hum: ); display.print(hum,1); display.println(%); display.display(); }