基于ESP32的智能环境监测站：从硬件选型到数据可视化的物联网实践

1. 项目概述：从“天气站”到“智能环境感知节点”

“WIFI Weather station”，字面意思是一个连接了Wi-Fi的天气站。乍一听，这似乎是个简单的DIY项目：找个传感器测测温湿度，连上Wi-Fi把数据发出去就完事了。但如果你真的动手做过，或者深入思考过它的应用场景，你就会发现，这个简单的标题背后，藏着一个非常经典的物联网（IoT）入门与进阶的完整路径。它绝不仅仅是一个显示温度的小玩意儿，而是一个微型的、部署在本地网络中的环境数据感知与传输节点。

我最初接触这类项目，是想解决一个很实际的问题：家里不同房间的温湿度差异其实挺大的，单纯看气象台的预报或者客厅的一个温湿度计，并不能准确指导我该不该给书房加湿，或者地下室是否需要除湿。市面上的智能设备要么太贵，要么数据不开放，无法集成到我自己的智能家居系统中。于是，自己动手搭建一个低成本、可定制、数据自主的Wi-Fi天气站，就成了最直接的解决方案。

这个项目的核心价值在于，它麻雀虽小，五脏俱全，完整涵盖了物联网的几个关键环节：感知（传感器采集）、连接（Wi-Fi网络）、处理（微控制器逻辑）和呈现（数据展示）。通过它，你可以实践从硬件选型、电路连接、嵌入式编程、网络通信到数据可视化的全流程。无论是嵌入式开发新手想入门物联网，还是有一定经验的开发者想快速验证一个传感器方案，这个项目都是一个极佳的练手选择。

2. 核心硬件选型与设计思路拆解

一个Wi-Fi天气站的硬件核心主要由三部分组成：主控单元、传感器模块和电源部分。选型的过程，本质上是在性能、成本、功耗和开发便利性之间寻找平衡点。

2.1 主控芯片：ESP32为何是首选？

在Wi-Fi物联网领域，Espressif公司的ESP32系列芯片几乎是无可争议的王者。对于我们的天气站项目，选择ESP32（尤其是像ESP32-S3、ESP32-C3这类较新的型号）主要基于以下几点考量：

1. 双核处理器与充足内存：ESP32通常拥有两个Xtensa LX6内核（或RISC-V内核），主频高达240MHz，内置520KB SRAM和4MB Flash。这意味着它有足够的算力来同时处理传感器数据读取、Wi-Fi连接维护、数据协议封装等任务，而不会显得捉襟见肘。你可以轻松地运行一个轻量级的Web服务器来提供配置页面，或者处理复杂的JSON数据。

2. 集成双模Wi-Fi与蓝牙：芯片原生集成了2.4GHz Wi-Fi（802.11 b/g/n）和蓝牙，无需外接模块，极大地简化了电路设计和降低了整体成本。Wi-Fi部分支持Station模式（连接家庭路由器）、AP模式（自身作为热点）以及混合模式，为设备入网提供了极大的灵活性。

3. 丰富的外设接口：ESP32提供了多个GPIO、UART、I2C、SPI、ADC等接口。我们的温湿度、气压等传感器大多通过I2C或SPI通信，ESP32可以轻松连接多个传感器，扩展性很强。其内置的霍尔传感器、触摸电容传感器等，虽然本项目用不上，但也说明了其功能的丰富性。

4. 成熟的生态与低功耗支持：无论是官方的ESP-IDF开发框架，还是基于Arduino核心的封装，都有极其庞大的社区和丰富的库支持。遇到任何传感器驱动或网络问题，几乎都能找到现成的案例或解决方案。此外，ESP32支持深度睡眠（Deep Sleep），在仅由电池供电且需要长时间运行的场景下，可以通过定时唤醒采集数据再休眠的方式，极大延长续航。

对比与备选：像STM32+ESP8266模组的组合也是一种方案，但ESP8266性能较弱、外设少，且需要额外的串口通信，复杂度反而增加。树莓派Pico W虽然也有Wi-Fi，但其生态更偏向MicroPython，在纯C/C++的嵌入式实时性控制方面，不如ESP32的ESP-IDF框架来得直接和高效。因此，对于绝大多数天气站应用，ESP32是性价比和易用性最高的起点。

2.2 传感器模块选型：精度、接口与稳定性

传感器的选择直接决定了数据的质量。一个基础的天气站通常需要监测温度、湿度和大气压力。

1. 温湿度传感器：

   • DHT11/DHT22：这是最入门的选择，价格低廉，使用单总线通信。但DHT11精度较低（湿度±5%，温度±2℃），响应慢，且在读取间隔上有限制。DHT22精度更好，但仍存在一些稳定性问题，特别是在高湿环境下。对于要求不高的室内监测，可以选用。
   • SHT30/SHT31：我强烈推荐使用Sensirion的SHT3x系列。它采用I2C接口，精度高（湿度±2%，温度±0.2℃），响应速度快，长期稳定性好。虽然价格比DHT系列高，但对于一个希望数据可靠、能真正用于环境调节参考的项目来说，这点投资是值得的。

2. 气压传感器：

   • BMP280/BME280：Bosch的这两款传感器非常流行。BMP280测量气压和温度，BME280则在BMP280基础上增加了湿度测量功能。它们精度高、功耗低，通过I2C或SPI通信。如果你已经选了SHT30测温湿度，那么搭配一个BMP280专精于气压测量是很好的选择；如果你想简化硬件，一个BME280就能同时提供温湿压三样数据，但温湿度精度略逊于专门的SHT30。

3. 其他可选传感器：

   • 光照传感器：如BH1750，用于监测室内光线强度，可以联动智能灯光。
   • 空气质量传感器：如SGP30（TVOC和eCO2）或PMS5003（PM2.5/PM10），用于构建更全面的室内环境监测站。
   • 颗粒物传感器：如攀藤的PMS系列，精度高但需要较大的风扇，功耗和体积都比较大，适合有特定空气质量监测需求的场景。

实操心得：传感器不是越多越好。每增加一个传感器，就意味着更多的代码、更复杂的供电考虑和潜在的数据干扰。建议从核心的温湿压开始，确保一个传感器稳定工作了，再考虑扩展。另外，购买传感器时，尽量选择带有电平转换和滤波电容的“模块”，而不是裸芯片，这能省去很多电路调试的麻烦。

2.3 电源方案设计：稳定是数据的基石

天气站通常需要7x24小时运行，一个稳定可靠的电源方案至关重要。

1. USB供电：最简单的方式是通过Micro-USB或Type-C接口，连接手机充电器或电脑USB口供电。优点是稳定方便，缺点是需要一直占用一个插座，且线缆可能影响美观。

2. 电池供电：对于想放在阳台、花园等无插座位置的应用，电池供电是必须的。ESP32在持续Wi-Fi连接下的工作电流可能达到100mA以上，普通干电池很快会耗尽。

   • 方案一（主动式）：使用大容量的18650锂离子电池（约3000mAh）搭配TP4056充电管理模块和升压模块（将3.7V升至5V）。这是最经典的方案，电量足，可充电。
   • 方案二（低功耗式）：利用ESP32的深度睡眠功能。让设备每5分钟唤醒一次，连接Wi-Fi、读取传感器、发送数据，然后立即进入深度睡眠。在深度睡眠下，电流可以降至10μA级别。这样，即使使用小容量的电池，也能运行数周甚至数月。这是实现长期无人值守监测的关键技巧。

3. 电源噪声处理：无论哪种供电方式，都建议在ESP32的电源输入引脚附近放置一个100μF的电解电容和一个0.1μF的陶瓷电容，用于滤除低频和高频噪声，防止因电源波动导致系统重启或传感器读数异常。

3. 软件架构与通信协议详解

硬件是躯体，软件是灵魂。天气站的软件设计需要兼顾可靠性、可维护性和低功耗。

3.1 开发框架选择：ESP-IDF vs. Arduino Core

ESP32有两种主流的开发方式：

1. ESP-IDF：这是乐鑫官方的物联网开发框架，基于FreeRTOS，功能最全、最底层，对芯片特性的控制力最强，尤其适合需要精细控制功耗、使用复杂外设或追求极致性能的项目。学习曲线相对陡峭。
2. Arduino Core for ESP32：这是在ESP-IDF之上封装的一层Arduino兼容库。它继承了Arduino简单的setup()和loop()编程模型，有海量的现成传感器库，开发速度快，入门极其容易。对于天气站这类功能相对固定的项目，Arduino Core通常是更高效的选择。

我的选择：对于快速原型验证和个人项目，我优先使用Arduino Core。它的生态太好了，几乎任何传感器都能找到对应的库，让我能专注于业务逻辑而不是驱动调试。当项目需要深度睡眠、OTA升级等稍复杂的功能时，Arduino Core也提供了足够的支持。只有在需要用到ESP32某些非常特殊的硬件功能时，我才会考虑直接使用ESP-IDF。

3.2 网络连接与稳健性处理

让设备稳定地连接Wi-Fi是第一步，也是最容易出问题的一步。

// 示例：基于Arduino Core的Wi-Fi连接与重连逻辑 #include <WiFi.h> #include <WiFiMulti.h> WiFiMulti wifiMulti; const char* ssid1 = "Your_SSID_1"; const char* password1 = "Your_PASSWORD_1"; const char* ssid2 = "Your_SSID_2"; // 可配置备用网络 const char* password2 = "Your_PASSWORD_2"; void setup() { Serial.begin(115200); wifiMulti.addAP(ssid1, password1); wifiMulti.addAP(ssid2, password2); Serial.println("Connecting to WiFi..."); // 设置连接超时，避免无限等待 if (wifiMulti.run(10000) == WL_CONNECTED) { Serial.println("WiFi connected!"); Serial.print("IP address: "); Serial.println(WiFi.localIP()); } else { Serial.println("WiFi connection FAILED"); // 此处可以触发错误处理，如进入深度睡眠等待下次重试，或闪烁LED告警 goToDeepSleep(60); // 连接失败，休眠60秒再试 } } void loop() { // 定期检查连接状态，如果断开则尝试重连 if (WiFi.status() != WL_CONNECTED) { Serial.println("WiFi lost. Reconnecting..."); if (wifiMulti.run(5000) != WL_CONNECTED) { Serial.println("Reconnect failed."); } } // ... 其他主循环逻辑 }

关键点解析：

• 使用WiFiMulti：它允许配置多个AP（接入点），设备会按顺序尝试连接，增加了可靠性。
• 设置超时：run(10000)表示尝试连接10秒，超时后视为失败，执行后续逻辑，防止程序卡死。
• 状态监测与重连：在loop()中定期检查连接状态，断开后自动重连，这是保证设备长期在线的基础。
• 失败处理：连接失败后，不是让程序死等，而是根据场景选择策略。例如，电池供电的设备可以进入深度睡眠，节省电量，过段时间再唤醒重试。

3.3 数据上报协议：MQTT vs. HTTP REST

数据采集后，需要发送到服务器或云端进行存储和展示。主流协议有MQTT和HTTP。

1. MQTT（消息队列遥测传输）：

   • 优点：专为物联网设计的轻量级发布/订阅协议，开销小，功耗低，支持QoS（服务质量等级），适合网络不稳定的环境。设备将数据发布（Publish）到特定的主题（Topic），服务器订阅该主题即可接收。
   • 适用场景：数据上报频率高、设备数量多、对实时性要求高、且网络可能不稳定的情况。例如，每10秒上报一次数据。
   • 实现简述：需要在本地或云端搭建一个MQTT Broker（如Mosquitto, EMQX）。ESP32使用PubSubClient库连接到Broker，并定时向如home/weather_station/living_room这样的主题发布JSON格式的数据。

2. HTTP REST：

   • 优点：基于万维网的基础协议，理解和使用简单，无需额外的中间件（Broker）。直接向一个HTTP API端点发送POST或GET请求即可。
   • 适用场景：数据上报频率较低（如每分钟或每5分钟一次），逻辑简单，或者后端服务本身就是基于HTTP的。
   • 实现简述：ESP32使用HTTPClient库，构造一个包含传感器数据的JSON字符串，POST到像http://your-server.com/api/sensor-data这样的URL。

我的选择与建议：对于个人项目，如果数据上报不频繁（>30秒一次），我倾向于使用HTTP。因为它最简单，我可以在云服务器上用Python Flask或Node.js快速写一个接收接口，数据直接存入数据库（如InfluxDB、MySQL）。如果设备很多，或者未来考虑构建复杂的设备间通信，MQTT是更专业的选择。一个折中的高级方案是使用HTTP，但在代码中实现一个简单的重试和缓存队列，如果本次发送失败，则将数据暂存，下次网络恢复时一并发送，这能大大提高数据的可靠性。

4. 完整实现步骤与代码解析

下面，我将以一个基于ESP32（Arduino Core）、SHT30温湿度传感器、BMP280气压传感器，并通过HTTP上报数据到自制服务器的天气站为例，拆解实现步骤。

4.1 硬件连接

首先，将传感器连接到ESP32开发板（以常见的ESP32 DevKit V1为例）。

传感器引脚	ESP32 GPIO引脚	说明
SHT30
VCC	3.3V	电源正极
GND	GND	电源地
SCL	GPIO 22	I2C时钟线
SDA	GPIO 21	I2C数据线
BMP280
VCC	3.3V	电源正极
GND	GND	电源地
SCK	GPIO 22	I2C时钟线（与SHT30共用）
SDI	GPIO 21	I2C数据线（与SHT30共用）

注意：多个I2C设备可以共享SCL和SDA线，每个设备有唯一的I2C地址。SHT30的地址通常是0x44或0x45，BMP280的地址是0x76或0x77，通过模块上的跳线帽选择。确保它们的地址不冲突。

4.2 Arduino代码实现

1. 安装必要的库：在Arduino IDE的库管理中，搜索并安装以下库：

   • Adafruit SHT31(用于SHT30)
   • Adafruit BMP280(用于BMP280)
   • WiFi(通常已包含在ESP32核心中)
   • HTTPClient(通常已包含在ESP32核心中)
   • ArduinoJson(用于构建和解析JSON数据，强烈推荐安装)

2. 主要代码结构：

#include <Wire.h> #include <WiFi.h> #include <HTTPClient.h> #include <ArduinoJson.h> #include <Adafruit_SHT31.h> #include <Adafruit_BMP280.h> // 网络配置 const char* ssid = "Your_WiFi_SSID"; const char* password = "Your_WiFi_Password"; const char* serverUrl = "http://your-server.com:8080/api/sensor"; // 你的数据接收API地址 // 传感器对象 Adafruit_SHT31 sht30 = Adafruit_SHT31(); Adafruit_BMP280 bmp280; // 全局变量存储读数 float temperature_sht = 0.0; float humidity = 0.0; float pressure = 0.0; float temperature_bmp = 0.0; void setup() { Serial.begin(115200); Wire.begin(); // 初始化I2C // 1. 初始化传感器 initSensors(); // 2. 连接Wi-Fi connectToWiFi(); // 3. 首次数据读取与上报 readSensors(); sendDataToServer(); } void loop() { // 每30秒读取并上报一次数据 delay(30000); readSensors(); // 简单的数据合理性检查 if (!isnan(temperature_sht) && !isnan(humidity) && pressure > 80000) { sendDataToServer(); } else { Serial.println("Invalid sensor data, skipping this transmission."); } } void initSensors() { // 初始化SHT30 if (!sht30.begin(0x44)) { // 根据你的模块地址调整 Serial.println("Could not find a valid SHT30 sensor, check wiring!"); while (1); } Serial.println("SHT30 initialized."); // 初始化BMP280 if (!bmp280.begin(0x76)) { // 根据你的模块地址调整 Serial.println("Could not find a valid BMP280 sensor, check wiring!"); while (1); } // 配置BMP280，例如设置采样模式、滤波器等 bmp280.setSampling(Adafruit_BMP280::MODE_NORMAL, /* 模式 */ Adafruit_BMP280::SAMPLING_X2, /* 温度采样 */ Adafruit_BMP280::SAMPLING_X16, /* 压力采样 */ Adafruit_BMP280::FILTER_X16, /* 滤波器 */ Adafruit_BMP280::STANDBY_MS_500); /* 待机时间 */ Serial.println("BMP280 initialized."); } void connectToWiFi() { WiFi.begin(ssid, password); Serial.print("Connecting to WiFi"); int attempts = 0; while (WiFi.status() != WL_CONNECTED && attempts < 20) { delay(500); Serial.print("."); attempts++; } if (WiFi.status() == WL_CONNECTED) { Serial.println("\nConnected! IP address: "); Serial.println(WiFi.localIP()); } else { Serial.println("\nFailed to connect to WiFi. Check credentials."); // 在实际项目中，这里可能需要进入错误处理循环或深度睡眠 } } void readSensors() { temperature_sht = sht30.readTemperature(); humidity = sht30.readHumidity(); temperature_bmp = bmp280.readTemperature(); pressure = bmp280.readPressure() / 100.0F; // 转换为百帕(hPa) Serial.print("SHT30 - Temp: "); Serial.print(temperature_sht); Serial.print(" °C, Hum: "); Serial.print(humidity); Serial.println(" %"); Serial.print("BMP280 - Temp: "); Serial.print(temperature_bmp); Serial.print(" °C, Pres: "); Serial.print(pressure); Serial.println(" hPa"); } void sendDataToServer() { if (WiFi.status() != WL_CONNECTED) { Serial.println("WiFi not connected, attempting to reconnect..."); connectToWiFi(); if (WiFi.status() != WL_CONNECTED) { return; // 重连失败，放弃本次发送 } } HTTPClient http; http.begin(serverUrl); http.addHeader("Content-Type", "application/json"); // 使用ArduinoJson库构建JSON数据 StaticJsonDocument<200> doc; doc["device_id"] = "weather_station_01"; // 设备唯一标识 doc["temperature"] = temperature_sht; // 使用SHT30的温度，通常更准 doc["humidity"] = humidity; doc["pressure"] = pressure; doc["timestamp"] = millis(); // 简单的时间戳，实际应用应使用NTP获取真实时间 String jsonString; serializeJson(doc, jsonString); int httpResponseCode = http.POST(jsonString); if (httpResponseCode > 0) { String response = http.getString(); Serial.print("HTTP Response code: "); Serial.print(httpResponseCode); Serial.print(", Response: "); Serial.println(response); } else { Serial.print("Error sending POST request: "); Serial.println(httpResponseCode); Serial.println(http.errorToString(httpResponseCode).c_str()); } http.end(); }

代码关键点解析：

• 传感器初始化：在setup()中初始化所有传感器，并检查是否成功，失败则阻塞并提示，便于调试。
• Wi-Fi重连逻辑：在sendDataToServer()函数开头检查Wi-Fi状态，如果断开则尝试重连。这是一个简单的稳健性增强。
• 数据校验：在loop()中发送数据前，使用isnan()和范围检查对传感器读数进行简单校验，避免发送无效数据。
• JSON序列化：使用ArduinoJson库构建JSON字符串，比手动拼接字符串更安全、高效，且易于扩展字段。
• HTTP通信：使用HTTPClient进行POST请求，并检查返回码，便于排查服务器端问题。

4.3 服务器端数据接收（Python Flask示例）

你需要在服务器上运行一个简单的后端程序来接收ESP32发来的数据。这里给出一个极简的Python Flask示例，将数据打印出来并存入SQLite数据库。

# server.py from flask import Flask, request, jsonify import sqlite3 from datetime import datetime import json app = Flask(__name__) DATABASE = 'weather_data.db' def init_db(): conn = sqlite3.connect(DATABASE) c = conn.cursor() c.execute('''CREATE TABLE IF NOT EXISTS sensor_data (id INTEGER PRIMARY KEY AUTOINCREMENT, device_id TEXT, temperature REAL, humidity REAL, pressure REAL, timestamp INTEGER, server_received_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP)''') conn.commit() conn.close() @app.route('/api/sensor', methods=['POST']) def receive_sensor_data(): data = request.get_json() if not data: return jsonify({'error': 'No JSON data received'}), 400 # 简单验证必要字段 required_fields = ['device_id', 'temperature', 'humidity', 'pressure', 'timestamp'] for field in required_fields: if field not in data: return jsonify({'error': f'Missing field: {field}'}), 400 # 存入数据库 conn = sqlite3.connect(DATABASE) c = conn.cursor() c.execute('''INSERT INTO sensor_data (device_id, temperature, humidity, pressure, timestamp) VALUES (?, ?, ?, ?, ?)''', (data['device_id'], data['temperature'], data['humidity'], data['pressure'], data['timestamp'])) conn.commit() conn.close() print(f"Received data: {data}") return jsonify({'status': 'success', 'message': 'Data saved'}), 200 if __name__ == '__main__': init_db() app.run(host='0.0.0.0', port=8080, debug=True)

运行这个脚本（python server.py），你的ESP32就能将数据发送到这台服务器的8080端口了。当然，生产环境你需要考虑使用更健壮的Web框架（如FastAPI）、数据库（如InfluxDB，专为时间序列数据优化）以及安全措施（如API密钥验证）。

5. 进阶优化与功能扩展

基础功能实现后，可以从以下几个方面进行优化和扩展，让天气站变得更实用、更智能。

5.1 实现深度睡眠以极致省电

这是让电池供电设备长期运行的核心技术。修改之前的代码，让ESP32在每次发送数据后进入深度睡眠，由定时器或外部信号唤醒。

// 引入深度睡眠头文件 #include <esp_sleep.h> // 定义唤醒时间间隔（单位：微秒） #define uS_TO_S_FACTOR 1000000ULL #define TIME_TO_SLEEP 300 // 休眠300秒（5分钟） void setup() { Serial.begin(115200); Serial.println("Booted from deep sleep"); // 初始化传感器、连接Wi-Fi、读取数据、发送数据... initSensors(); connectToWiFi(); readSensors(); sendDataToServer(); Serial.println("Going to deep sleep now"); delay(100); // 等待串口发送完成 // 配置唤醒源为定时器 esp_sleep_enable_timer_wakeup(TIME_TO_SLEEP * uS_TO_S_FACTOR); // 进入深度睡眠 esp_deep_sleep_start(); // 程序在此处停止，直到被唤醒后从setup()重新开始 } void loop() { // 深度睡眠模式下，loop()永远不会被执行 }

注意事项：

• GPIO状态：进入深度睡眠前，最好将不用的GPIO设置为低电平或上拉/下拉，以降低功耗。
• RTC内存：深度睡眠下，只有RTC慢速内存和RTC寄存器中的数据会保留。如果需要保存一些状态变量，需要使用RTC_DATA_ATTR属性来定义它们。
• 传感器功耗：如果传感器本身功耗较大，在睡眠前也应将其设置为低功耗模式或直接断电。

5.2 添加Web配置界面

硬编码Wi-Fi的SSID和密码很不方便。可以给ESP32添加一个配网功能。常见有两种方式：

1. SmartConfig / WPS：利用手机APP（如EspTouch）发送Wi-Fi信息给设备。需要手机配合。
2. Web配网（AP模式）：设备启动时，如果检测到没有保存的Wi-Fi配置，则自身开启一个Wi-Fi热点（AP）。用户手机连接这个热点后，访问一个特定的IP地址（如192.168.4.1），会看到一个网页，在页面上选择家庭Wi-Fi并输入密码。提交后，ESP32用这些信息去连接网络，成功后保存至文件系统或Preferences中。

Web配网更通用，推荐使用WiFiManager这个库来实现，它能自动完成上述所有流程，你只需要几行代码就能集成。

5.3 数据可视化展示

数据存到数据库后，最终目的是为了看。有多个轻量级的方案：

1. Grafana：这是最强大、最美观的选择。它是一个开源的数据可视化和监控平台，支持多种数据源（包括InfluxDB、MySQL、PostgreSQL等）。你可以轻松地创建带有曲线图、仪表盘、表格的看板，实时展示温度、湿度、压力的变化趋势，并且可以设置报警规则。
2. 自制简单网页：如果你喜欢动手，可以用Python的Flask或FastAPI框架，写一个简单的网页，用Chart.js或ECharts这样的前端图表库来绘制历史数据曲线。
3. Home Assistant集成：如果你在用Home Assistant这个开源家庭自动化平台，可以通过其MQTT或RESTful Sensor组件，将你的天气站数据接入HA。这样，你的环境数据就能和家里的其他智能设备联动了，比如“当湿度高于70%时，自动打开空调除湿”。

6. 常见问题排查与调试心得

在制作和部署过程中，你肯定会遇到各种各样的问题。这里记录一些我踩过的坑和解决方法。

6.1 传感器读数不稳定或为NaN

• 现象：温度、湿度读数偶尔跳变成NaN（非数字）或明显不合理的值。
• 排查：
  1. 电源问题：这是最常见的原因。用万用表测量传感器VCC引脚的实际电压，在ESP32全速运行和Wi-Fi通信时，3.3V电源可能会被拉低到3.0V以下，导致传感器工作异常。确保电源线够粗，并在传感器电源引脚就近增加一个10μF以上的电容。
  2. I2C总线干扰：I2C总线对走线长度和干扰敏感。尽量使用短导线连接（<20cm），并将SDA和SCL线双绞。如果导线必须很长，可以考虑在总线上加上拉电阻（通常模块上已集成，但可以尝试减小阻值，如从10kΩ改为4.7kΩ以增强驱动能力）。
  3. 库冲突或版本问题：确保使用的传感器库是最新的，并且与你的开发板框架兼容。有时不同库对I2C的操作有细微差别。
• 解决：在代码中加入重试机制。如果一次读取失败或得到NaN，延迟几毫秒再读一次，连续失败几次后再报错。

6.2 Wi-Fi连接时好时坏，经常断开

• 现象：设备运行一段时间后，Wi-Fi断开，无法发送数据。
• 排查：
  1. 信号强度：ESP32的Wi-Fi接收灵敏度不如手机或路由器。用手机测一下设备放置位置的信号强度（RSSI），如果低于-70dBm，就可能不稳定。可以尝试调整设备或路由器的位置，或者使用Wi-Fi中继器。
  2. 路由器设置：有些路由器的“节能模式”或“无线隔离”功能可能导致IoT设备连接不稳定。尝试在路由器后台关闭这些功能。确保路由器信道没有过多干扰（可以用Wi-Fi分析仪APP查看）。
  3. ESP32电源：Wi-Fi发射时电流峰值很大，劣质USB线或供电不足的电源适配器会导致电压骤降，引起系统复位或Wi-Fi模块工作异常。
• 解决：除了优化硬件，在软件上要加强重连逻辑。不要只在发送数据前检查，可以设置一个定时器，每隔一段时间（如30秒）主动检查一次连接状态并尝试重连。

6.3 数据发送失败，服务器收不到

• 现象：ESP32串口打印显示发送POST请求，但服务器端没有收到，或者返回错误码。
• 排查：
  1. 网络可达性：首先确保运行服务器的电脑/云主机防火墙开放了对应的端口（如8080），并且ESP32所在的网络能访问到该服务器的IP和端口。可以在同一网络下的电脑上用浏览器或curl命令测试API是否通。
  2. HTTPS vs HTTP：如果你的服务器使用了HTTPS（推荐），那么ESP32代码中的URL必须是https://开头，并且可能需要处理SSL证书验证（对于自签名证书，需要添加根证书或跳过验证，但后者不安全）。
  3. 服务器日志：查看服务器应用程序的日志，看是否有请求到达，以及错误信息是什么。Flask的debug=True模式会输出详细日志。
  4. ESP32错误码：HTTPClient返回的错误码很有用。-1通常表示连接失败（检查网络），-11表示连接超时（检查服务器响应速度或网络延迟）。
• 解决：在ESP32代码中完善错误处理，将HTTP错误码和服务器返回的内容都打印出来。对于不稳定的网络，实现一个数据发送队列，失败的数据暂存到SPIFFS文件系统中，下次网络恢复时优先发送。

6.4 深度睡眠后无法唤醒或行为异常

• 现象：配置了深度睡眠后，设备睡下去就再也没醒过来，或者唤醒后程序从头开始但变量值丢了。
• 排查：
  1. 唤醒源配置：确认esp_sleep_enable_timer_wakeup()的参数单位是微秒，且计算正确。例如，睡眠5分钟应该是5 * 60 * 1000000微秒。
  2. GPIO引脚状态：有些GPIO在深度睡眠下如果保持高电平或浮空，可能会产生漏电流，消耗额外电量甚至影响唤醒。查阅ESP32技术手册，将未使用的GPIO设置为下拉模式。
  3. RTC内存使用：需要跨睡眠周期保存的变量，必须用RTC_DATA_ATTR定义，例如RTC_DATA_ATTR int bootCount = 0;。普通全局变量在深度睡眠后会被重置。
• 解决：在进入深度睡眠前，通过串口打印出计划睡眠的时间和关键的RTC变量值。唤醒后，首先打印这些值，确认睡眠时长是否正确以及RTC数据是否保存成功。这是一个有效的调试手段。

制作一个稳定可靠的Wi-Fi天气站，是一个不断遇到问题、解决问题的过程。从最基础的传感器读数，到稳定的网络通信，再到低功耗运行和美观的数据展示，每一步都蕴含着许多细节。但正是这些细节，区分了一个“玩具”和一个真正可用的工具。当你看到自己制作的设备稳定运行数周，并将清晰的环