很多人第一次玩 WiFi 温湿度传感器时最容易卡住的不是代码而是不知道这东西到底怎么连上网、怎么把数据传到手机里。明明硬件都买回来了传感器也接好了结果卡在 WiFi 配置或者搞不懂 MQTT 是什么最后只能吃灰。我当年也是这么走过来的所以这篇就把 WiFi 温湿度传感器从连接配置到接入 MQTT 的完整链路讲透包含选型思路、接线步骤、代码逻辑、常见坑点照着做基本能一次跑通。这篇内容适合三种人一是想给家里做环境监测但刚接触嵌入式的小白二是学校课程设计需要做温湿度采集上报的学生三是想在办公室或机房做远程温湿度监控的运维朋友。不管你是用 ESP8266、ESP32 还是其他 WiFi 模组核心配置思路都是通用的。1. 方案选型与连接思路2.4GHz 与 MQTT 的组合逻辑先解决一个根本问题为什么智能家居和物联网设备普遍选 2.4GHz WiFi而不是 5GHz为什么传输层要用 MQTT而不是更常见的 HTTP1.1 为什么 WiFi 传感器几乎都工作在 2.4GHz 频段WiFi 温湿度传感器本质上还是个小型嵌入式设备天线尺寸、射频功耗都受硬件体积限制。2.4GHz 频段在穿墙能力、覆盖距离上比 5GHz 有明显优势。传感器往往被放到阳台、仓库角落、设备机柜这种犄角旮旯的地方5GHz 信号容易被墙体或金属柜体削弱而 2.4GHz 的绕射能力稍好一些。更重要的是成本。主流 WiFi 模组尤其是 ESP 系列和各类国产透传模组多数只集成了 2.4GHz 射频前端。支持双频的模组成本会明显提升对于温湿度采集这种每秒才几十字节的小流量场景完全没必要多花那个钱。再说 2.4GHz 即使信道拥挤传这点数据也绰绰有余。配置时有个非常容易踩的坑很多家用路由器默认开启了“双频合一”即 2.4GHz 和 5GHz 共用同一个 SSID。此时传感器可能反复连接失败因为设备只会尝试连接信号较弱的 5GHz 或两个频段间反复横跳。建议进路由器管理后台把双频合一关闭或者给 2.4GHz 设置一个专用的传感器 WiFi 名称。另外一个容易被忽略的点是WiFi 配置的 SSID 和密码中最好不要出现中文字符或特殊符号。部分模块对 UTF-8 字符集支持不好遇到中文 SSID 会出现连不上或乱码。我曾经遇到过一台配了中文热点名称的测试路由ESP8266 死活连不上后来把热点名称改成纯英文一次就通了。这不是玄学是模块内部固件的字符编码问题有兼容性风险就需要主动规避。1.2 MQTT 比 HTTP 更适合传感器数据的几个理由如果传感器采集数据后通过 HTTP POST 到服务器也不是不行但你会遇到几个麻烦HTTP 是请求响应模式设备必须知道服务器的具体接口地址服务器还得维护一套鉴权、跨域等机制为了一条温湿度数据TCP 握手加 HTTP 头部可能要发几百字节功耗和流量都浪费了如果服务器没开请求就失败数据就丢了。MQTT 是发布订阅模型运行在 TCP 之上协议头最小可以压缩到 2 字节。传感器作为发布者把数据发布到某个主题Topic任何订阅了这个主题的客户端都能实时收到。设备完全不需要知道谁在消费数据订阅方也不需要知道数据从哪里来。这种松耦合设计让扩展设备变得非常容易加一个显示屏订阅同一个主题就行加一个手机 App 推送同样也是订阅主题。MQTT 还有个保留消息机制值得单独说。传感器每次上电后发布的最后一条消息Broker 可以保存下来新订阅者接入的瞬间就能立刻拿到最新的温湿度值不需要等传感器下一次上报。这在做监控看板时特别有用页面一打开就有数据不用干等。1.3 整体连接架构拆解一个典型的 WiFi 温湿度传感器系统大致是这种结构传感器(DHT11/SHT30) - 主控(ESP8266/ESP32) - 家庭路由器(2.4GHz) - MQTT Broker(Mosquitto等) - 订阅端(手机/电脑/Home Assistant)数据流从传感器采集开始主控读取温湿度数值后按固定间隔比如 10 秒打包成 JSON 报文通过 WiFi 推送到局域网内的 MQTT BrokerBroker 再转发给所有订阅了对应主题的客户端。这套架构最核心的优点是传感器跟订阅端完全解耦。我可以同时让手机 MQTT 客户端、Node-RED 看板、Home Assistant 三处订阅同一份数据互不影响。以后想加推送服务只用在 Broker 层面做规则配置传感器端一行代码都不用改。2. 硬件选型与环境准备从传感器到 Broker 的搭建细节方案定了之后剩下就是选具体的元器件和搭建软件环境。这里我把自己试过的组合和参数列一下照着买基本不会错。2.1 温湿度传感器怎么选DHT11、DHT22、SHT30 对比市面常见的温湿度传感器有 DHT11、DHT22/AM2302、SHT30 这几款参数差距还是不小的。我整理了一个对比表方便你按项目需求选传感器型号温度精度湿度精度采样周期接口类型典型价格稳定度DHT11±2℃±5% RH1s 以上单总线几块钱一般DHT22/AM2302±0.5℃±2% RH2s 以上单总线十几块中等SHT30±0.3℃±2% RH可配I2C十几到二十几高DHT11 最大的优势是便宜、资料多、教程满地都是做毕设和入门练手足够了。但你要准备长时间监测环境数据它的漂移和误差会有点让人头疼而且湿度的 ±5% 误差在实际项目中有时不太能接受。DHT22 精度相比 DHT11 提升不少价格也适中我目前的主力项目用的就是它。SHT30 走 I2C 接口数据稳定性和一致性在三者中最好适合对数据质量有要求的场景。不过 SHT30 是贴片封装面包板接线需要转接板新手需要多留意一下引脚间距的问题。还有个注意点不管用哪款传感器如果你的主控电源是同一个开关电源供电建议传感器供电跟主控之间加一个 100nF 去耦电容放在传感器电源引脚附近能明显减少读数跳变。这在电机、继电器等干扰源附近尤其重要。2.2 主控选型ESP8266 还是 ESP32做 WiFi 温湿度采集主控基本就是 ESP8266 和 ESP32 二选一。两者在 WiFi 连接上其实没有本质差异都是 2.4GHz都支持 MQTT 库区别主要在别的方面ESP8266单核主频 160MHz只有一个 ADCGPIO 较少但价格便宜板子正常十几块烧录简单功耗低。如果你只是接一个温湿度传感器哪怕要再接个 OLED 屏它的资源也完全够用。ESP32双核主频 240MHz蓝牙和 WiFi 可以同时工作ADC 精度更高GPIO 多支持电阻触摸、CAN、加密加速器等。如果你的项目后期要加摄像头、本地语音识别、显示屏刷 UI 这类重活儿选 ESP32 更省心。你搜过的“esp32蓝牙和wifi可以一起用吗”答案是能但它对传感器项目不来电。温湿度采集这么轻量的活ESP32 的大算力有点浪费反而因为硬件复杂导致功耗更高。所以我的建议是只做传感器上报选 ESP8266省电省心想顺便折腾点别的再上 ESP32。2.3 MQTT Broker本地起一个服务还是用云端MQTT 数据总要有地方接收这个接收方就是 Broker。Mosquitto 是目前最流行的开源 Broker支持 Windows、Linux、macOS还支持 Docker 部署。我个人强烈建议先把 Broker 跑在局域网内的电脑或树莓派上等系统稳定再考虑上云。本地启动 MosquittoWindows 解压版大约 20MB 不到装好后改一下配置文件mosquitto.conf允许匿名访问和监听 1883 端口即可。关键配置项listener 1883 allow_anonymous true如果你想设置账号密码加两行配置并生成密码文件mosquitto_passwd -c /etc/mosquitto/passwd sensor_user # 然后回到配置文件添加 password_file /etc/mosquitto/passwd allow_anonymous false如果要用云服务器跑 Broker记得在云控制台的安全组里放行 1883 端口TCP同时服务器本地防火墙也要放行。这一步是新手最容易踩的坑后面我会专门展开说。3. 实操连接与代码实现手把手把数据跑起来硬件选好了、Broker 也搭起来了接下来就是接线、写代码、验证数据。这一节的内容是全文的核心每一步我都会说明目的和原理。3.1 硬件接线以 ESP8266 DHT11 为例接线是整个过程中最直观的一步DHT11 模块通常是三针或四针引出。如果是三针模块VCC、DATA、GND接线如下DHT11 引脚ESP8266 引脚VCC3.3VDATAGPIO2D4GNDGND特别注意老式 DHT11 裸元件需要 VCC 和 DATA 之间接一个 4.7kΩ-10kΩ 上拉电阻但绝大多数市面上卖的 DHT11 蓝色模块已经内置了上拉电阻直接接就行。如果你不确定自己的模块有没有内置用万用表量一下 DATA 引脚对 VCC 的电阻是几十 kΩ 就是有了。接线完成之后上电看模块上的电源指示灯。如果灯亮但串口输出乱码先检查共地也就是确认 ESP8266 的 GND 和 DHT11 的 GND 连到同一点。共地是电信号回流的必要条件很多第一次玩单片机的朋友会在这里卡住。3.2 开发环境准备Arduino 还是 PlatformIO代码编写环境我推荐 Arduino IDE理由就一个ESP8266 相关的物联网例程最多出问题搜解决方案最好搜。PlatformIO 工程规范更适合大项目但传感器采集这个小体量用不上它的模块化优势。如果你之前用过 PlatformIO继续用也不影响核心库是通用的。Arduino IDE 里添加 ESP8266 开发板支持在“文件 - 首选项 - 附加开发板管理器网址”里填上http://arduino.esp8266.com/stable/package_esp8266com_index.json然后在“开发板管理器”里搜索 ESP8266安装对应版本。库方面需要装三个DHT sensor libraryAdafruit 维护Adafruit Unified SensorPubSubClientMQTT 客户端3.3 核心代码实现WiFi 连接与 MQTT 发布下面这份代码是基于 ESP8266 和 DHT11 的最小可运行版本做温湿度采集并按 10 秒间隔上报到 MQTT Broker。代码不复杂但每个环节我都写了注释和选择理由。#include ESP8266WiFi.h #include PubSubClient.h #include DHT.h // WiFi 配置务必使用 2.4GHz 频段且 SSID 建议不要有中文 const char* ssid Your_2.4G_WiFi; const char* password Your_Password; // MQTT Broker 地址局域网内填电脑 IP云端填服务器公网 IP const char* mqtt_server 192.168.1.100; const int mqtt_port 1883; const char* topic home/sensor/temp_humidity; // 传感器配置 #define DHTPIN 4 // GPIO2 对应 Arduino 引脚编号 4即 D4 #define DHTTYPE DHT11 // DHT22 请改成 DHT22 DHT dht(DHTPIN, DHTTYPE); WiFiClient espClient; PubSubClient client(espClient); unsigned long lastSend 0; const unsigned long interval 10000; // 10 秒上报一次 void setup() { Serial.begin(115200); dht.begin(); // 连接 WiFi WiFi.mode(WIFI_STA); WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { // 这里加一个 500ms 延时避免反复请求导致路由器负载过高 delay(500); Serial.print(.); } Serial.println(\nWiFi connected); Serial.print(IP address: ); Serial.println(WiFi.localIP()); // 配置 MQTT client.setServer(mqtt_server, mqtt_port); } void loop() { // 保持 MQTT 长连接断线自动重连 if (!client.connected()) { reconnect(); } client.loop(); // 定时读取并发布数据 if (millis() - lastSend interval) { float h dht.readHumidity(); float t dht.readTemperature(); // 读取失败处理DHT 传感器偶发超时非常常见跳过本次上报即可 if (isnan(h) || isnan(t)) { Serial.println(Failed to read from DHT sensor!); lastSend millis(); return; } // 构建 JSON 报文注意 JSON 里的双引号需要转义 String payload {\temperature\: String(t, 1) , \humidity\: String(h, 1) }; // 发布并打印结果 if (client.publish(topic, payload.c_str())) { Serial.println(Published: payload); } else { Serial.println(Publish failed); } lastSend millis(); } } void reconnect() { // 最多重试 5 次避免 Broker 挂掉时设备无限卡死 while (!client.connected()) { Serial.print(Attempting MQTT connection...); // 客户端 ID 必须唯一如果多个传感器需要单独命名比如 sensor_livingroom if (client.connect(ESP8266_Sensor_1)) { Serial.println(connected); } else { Serial.print(failed, rc); Serial.print(client.state()); Serial.println( try again in 2 seconds); delay(2000); } } }几个细节值得说道一下。GPIO2D4在 ESP8266 上是具备内部上拉的引脚但这也是启动时必须处于高电平的引脚如果 DHT11 模块没有内置上拉电阻你外接一个 10kΩ 上拉到 3.3V 即可。为什么特别提醒这个因为有些 DHT11 模块出厂接好了上拉有些没有接线前最好确认一下。代码里的client.connect(ESP8266_Sensor_1)第二个参数可以传用户名和密码client.connect(clientId, user, pass)如果你在 Mosquitto 里开启了账号验证就在这里填上。温湿度读取失败时我用了isnan()检查。DHT11 是单总线协议时序要求非常严格如果中断处理或供电波动导致时序被破坏读出来就很可能是 NAN。这种情况下跳过上报、重试下一次采样比卡死循环要合理得多。3.4 验证数据链路从 MQTTX 到命令行订阅代码烧录完成后打开串口监视器波特率 115200。你可以看到 WiFi 连接日志、获取到的 IP 地址以及每 10 秒一行“Published”输出。这说明设备端已经成功发布数据了。但设备发布成功只代表数据到了 Broker到底有没有人能收还得验证订阅端。最简单的方法是用 MQTTX 这个图形化客户端支持 Windows/macOS 和手机端新建连接Broker 地址填电脑局域网 IP端口 1883连上之后订阅home/sensor/temp_humidity主题就应该能收到类似下面的消息{temperature: 26.3, humidity: 58.4}如果不想装图形化工具直接用命令行也行。Linux/macOS 下如果安装了 Mosquitto 客户端工具包一行命令就能订阅mosquitto_sub -h 192.168.1.100 -p 1883 -t home/sensor/temp_humidity数据能打印出来整条链路就算彻底通了。接下来所有扩展比如接小屏显示、接微信推送、接报表统计都是基于这个主题再做文章。4. 常见连接故障与排查技巧我踩过的坑和解决实录无论配置文档写得再详细实际测试中总会碰到各种奇葩问题。我把最常见的连接故障和排查思路整理成表格再补充几个我实际遇到的案例。4.1 连接故障排查速查表现象排查方向解决方案WiFi 连不上 / 一直打印点频段问题关闭路由器双频合一为传感器单独设置 2.4GHz 频段的 SSIDWiFi 连不上 / SSID 有中文字符编码问题把 WiFi 名称临时改成纯英文测试WiFi 连上但 IP 获取失败DHCP 问题给设备绑定静态 IP或检查路由器地址池是否耗尽MQTT 连接失败 rc-2Broker 未启动或地址错确认 Mosquitto 服务已开ping一下 Broker 地址MQTT 连接失败 rc-4网络不通检查设备与 Broker 是否在同一网段防火墙是否拦截能连通但收不到数据主题不匹配检查发布端和订阅端的主题字符串是否完全一致数据每隔几次就丢一次采样周期过短DHT11 建议读取间隔不低于 1 秒取平均后上报4.2 案例一双频合一导致的反复掉线我给朋友装了一套温湿度监控传感器在书房路由器和电脑在客厅。设备刚通电时是好的能连上但每隔几分钟就掉线重连。一开始我以为是代码里的心跳间隔太短或者是模块供电不足排查了半天。后来登录路由器后台才发现客厅路由开启了“WiFi 信号优选”功能相当于双频合一。手机在这种设置下是无感的因为手机本身支持 5GHz会自动切过去。但 ESP8266 只有 2.4GHz 射频路由器每 5 分钟做一次频段引导扫描就会把设备踢下线。关闭这个功能后故障立即消失。所以当你遇到“过几分钟就掉线”的情况先别急着改代码进路由器后台看看频段设置。4.3 案例二公网 MQTT 连不上的三处防火墙有次我在阿里云服务器上搭好 Mosquitto本地 MQTTX 怎么都连不上客户端报的是连接超时。排查过程基本是按网络顺序走下来的第一步确认服务器本地监听是否正常执行ss -tlnp | grep 1883看到0.0.0.0:1883说明 Mosquitto 没有只监听回环地址。第二步检查操作系统防火墙。以 Firewalld 为例firewall-cmd --permanent --add-port1883/tcp firewall-cmd --reload第三步也是新手最容易被坑的检查云厂商安全组。阿里云、腾讯云的服务器外部流量要过安全组这一关安全组没放行 1883服务器内部怎么开放都是白搭。到控制台的“安全组 - 配置规则”里入方向放行 TCP 1883 端口即可。三层都打开后连接就通了。这个排查顺序我建议形成肌肉记忆先看本地监听再看系统防火墙最后看云安全组。4.4 案例三DHT11 读数反复跳变另一个经常出现的问题是温湿度读数波动非常大比如同一时刻温度从 25.3℃ 跳到 27.8℃ 再跳回 25.6℃。这不一定是传感器坏了更可能是供电噪声干扰。ESP8266 的 WiFi 发射瞬间电流会突然增大如果供电电路纹波大DHT11 的单总线时序就容易受干扰。解决方法是两个层面硬件上在 DHT11 的电源引脚并联一个 0.1μF 陶瓷电容靠近传感器放置效果最好软件上可以在连续读取 5 次之后取中位数。注意是中位数不是平均值因为极端的跳变值会把平均值拉偏而中位数可以比较稳定地反映真实数据。4.5 一个值得保留的习惯启用 MQTT 遗嘱消息最后分享一个很多教程不会提到的实用细节。如果传感器断电Broker 上不会主动告诉订阅端设备离线了除非你设置了遗嘱消息。在代码里加这几行client.setWill(home/sensor/status, offline, true);然后在设备成功连接后发布一条在线消息client.publish(home/sensor/status, online, true);这样订阅端只要同时订阅home/sensor/status主题就能实时知道设备是活着还是掉线了。对运维监控场景来说这个功能比温湿度数据本身还要重要能让你在设备离线第一时间收到通知而不是翻看历史数据时才发现记录断了。我在实际项目里有个习惯是给传感器取清晰的客户端 ID比如按房间命名sensor_livingroom、sensor_serverroom。这么做不仅方便 Broker 层面做 ACL 权限隔离也让你在 MQTT 面板里看到一堆设备时能快速区分谁是谁。等到设备数量超过 5 个再想改命名就得一个个重新烧录那时候就知道当初的懒有多耽误事了。另外如果你准备把这个系统长期跑下去强烈建议在代码里把 WiFi 重连和 MQTT 重连做成独立的非阻塞逻辑不要在loop()里用while(1)死等。ESP8266 SDK 底层的 lwIP 协议栈对频繁阻塞重连很不友好连续重连 10 次以上有时会直接把协议栈搞死只能断电重启。我当时为了解决这个问题特意把重连间隔改成按指数退避从 2 秒、4 秒、8 秒一直加到 60 秒上限效果非常明显。这些细节看起来不起眼但恰恰是设备稳定跑几个月不重启的关键。