树莓派温湿度监控实战：从传感器读取到HTTP上传，一气呵成
你有没有想过，让一块几十块钱的树莓派变成一个能“说话”的智能设备？比如它自己感知环境变化，再主动把数据发到网上，供你在任何地方查看——这正是物联网最基础、也最迷人的能力之一。
在高校电子信息类专业的课程设计中，“树莓派小项目”早已不是新鲜事。但很多同学做到点亮LED就停下了，最多加个LCD显示温度。其实只要再多走一步——把数据传出去，整个项目的工程价值和学习深度都会跃升一个台阶。
今天我们就来干这件“多走一步”的事：
👉 用树莓派 + DHT22传感器采集温湿度，
👉 通过HTTP协议将数据上传至服务器，
👉 实现一个完整、可运行、贴近真实场景的物联网边缘节点。
不讲虚的，全程基于Python实现，代码可直接复用，适合课程设计、毕业设计或个人实践。准备好了吗？我们开始。
为什么选HTTP做数据上传？
说到物联网通信，很多人第一反应是MQTT、CoAP这些“专业”协议。没错，它们更轻量、更适合低功耗设备。但对于初学者，尤其是教学场景下的课程设计来说，HTTP依然是最优起点。
原因很简单：
- ✅ 几乎所有后端语言都支持接收HTTP请求（PHP、Flask、Spring Boot……随便写）；
- ✅ 调试极其方便，浏览器F12就能看接口是否通；
- ✅ 可以快速对接Web前端，展示成图表；
- ✅ 学生无需额外学习复杂协议栈，专注理解“数据如何流动”。
更重要的是，你现在手机上打开的每一个App，背后90%的数据交换，仍然是基于HTTP(S)完成的。学会它，就是踩在了现实世界的地基上。
硬件准备与连接：树莓派 + DHT22怎么接？
我们要用的核心组件非常简单：
| 组件 | 型号/说明 |
|---|---|
| 主控板 | 树莓派 3B+/4B/Zero W（带Wi-Fi即可） |
| 温湿度传感器 | DHT22（数字输出，单总线通信） |
| 其他 | 杜邦线若干、面包板、10kΩ上拉电阻 |
💡 小贴士：DHT22比DHT11精度高得多（±0.5°C vs ±2°C），价格也只贵几块钱，建议直接上DHT22。
接线方式如下：
| DHT22引脚 | 连接目标 |
|---|---|
| VCC（正极） | 树莓派 3.3V 或 5V（推荐3.3V） |
| GND（负极） | 树莓派 GND |
| DATA（数据） | GPIO4（物理引脚7） |
| —— | 并联一个10kΩ电阻在DATA与VCC之间（提高稳定性） |
📌注意：DHT22使用单总线协议，对时序要求严格，务必加上拉电阻！否则容易出现“偶尔读不到数据”的问题。
接好线后，先别急着写上传逻辑——咱们得先确认树莓派能正确读出温湿度。
第一步：让树莓派“看懂”DHT22的数据
虽然DHT22输出的是数字信号，但它不是I2C也不是SPI，而是一种私有的单总线协议。手动解析电平跳变太麻烦，好在社区有成熟库可用。
我们使用Adafruit_DHT库，它是专为这类传感器设计的经典工具。
安装依赖库
sudo apt update sudo apt install python3-pip pip3 install Adafruit_DHT⚠️ 注意：如果你用的是树莓派5，请安装新版：
bash pip3 install --upgrade adafruit-circuitpython-dht sudo apt install libgpiod2
测试读取代码
保存为read_sensor.py：
import Adafruit_DHT import time # 配置传感器类型和GPIO引脚 SENSOR = Adafruit_DHT.DHT22 PIN = 4 # GPIO4，对应物理引脚7 print("📊 开始读取DHT22数据...") while True: humidity, temperature = Adafruit_DHT.read_retry(SENSOR, PIN) if humidity is not None and temperature is not None: print(f"🌡️ {time.strftime('%H:%M:%S')} | " f"温度: {temperature:.1f}°C, " f"湿度: {humidity:.1f}%") else: print(f"⚠️ {time.strftime('%H:%M:%S')} | 读取失败，检查接线") time.sleep(2)运行：
python3 read_sensor.py如果一切正常，你会看到类似这样的输出：
📊 开始读取DHT22数据... 🌡️ 10:05:01 | 温度: 24.6°C, 湿度: 58.2% 🌡️ 10:05:03 | 温度: 24.7°C, 湿度: 58.1% ...✅ 成功！你的树莓派已经能感知世界了。
第二步：把数据“扔”到网上去——HTTP POST上传
现在我们有了数据，下一步就是把它送到远程服务器。这里我们采用最常见的HTTP POST + JSON方式。
假设你有一个公网接口地址（比如你自己搭的Flask服务）：
http://your-server.com/api/sensor它期待收到这样的JSON数据：
{ "device": "raspi_lab_01", "temp": 24.6, "humi": 58.2, "ts": "2025-04-05T10:05:01Z" }那我们的任务就很清楚了：构造这个结构，然后发出去。
安装requests库
pip3 install requests数据上传函数
添加以下函数到你的脚本中：
import requests import json SERVER_URL = "http://your-server.com/api/sensor" # 替换为你的真实地址 def upload_data(payload): headers = {'Content-Type': 'application/json'} try: response = requests.post( SERVER_URL, data=json.dumps(payload), headers=headers, timeout=10 ) if response.status_code == 200: print("✅ 数据上传成功") return True else: print(f"❌ 服务器返回错误码: {response.status_code}") return False except requests.exceptions.Timeout: print("⚠️ 请求超时，请检查网络或服务器状态") except requests.exceptions.ConnectionError: print("⚠️ 网络连接失败，请检查Wi-Fi配置") except Exception as e: print(f"⚠️ 未知异常: {e}") return False📌 关键点说明：
json.dumps()把Python字典转成标准JSON字符串；- 设置
timeout=10防止程序卡死； - 分类捕获常见异常，避免因一次断网导致整个程序崩溃。
合体！完整主程序来了
把前面两部分拼起来，再加上定时控制，就是一个完整的物联网终端程序了。
完整脚本：sensor_upload.py
#!/usr/bin/env python3 import time import requests import json import Adafruit_DHT # === 配置区 === SENSOR_PIN = 4 # DHT22连接的GPIO编号 SERVER_URL = "http://your-server.com/api/sensor" INTERVAL = 30 # 采集间隔（秒） DEVICE_ID = "raspi_lab_01" # 设备唯一标识 def collect_and_upload(): # 1. 读取传感器 humidity, temperature = Adafruit_DHT.read_retry(Adafruit_DHT.DHT22, SENSOR_PIN) if humidity is None or temperature is None: print(f"[{time.strftime('%H:%M:%S')}] ❌ 传感器读取失败") return False # 2. 构造数据包 payload = { "device": DEVICE_ID, "temp": round(temperature, 1), "humi": round(humidity, 1), "ts": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()) } # 3. 上传数据 headers = {'Content-Type': 'application/json'} try: resp = requests.post( SERVER_URL, data=json.dumps(payload), headers=headers, timeout=10 ) if resp.status_code == 200: print(f"[{payload['ts']}] ✅ 上报成功 → {payload}") return True else: print(f"[{payload['ts']}] ❌ 服务器错误 {resp.status_code}") return False except Exception as e: print(f"[{time.strftime('%H:%M:%S')}] ⚠️ 网络异常: {e}") return False # ============ 主循环 ============ if __name__ == "__main__": print("🚀 启动树莓派温湿度监控系统...") while True: collect_and_upload() time.sleep(INTERVAL)把这个文件放到树莓派上，运行：
python3 sensor_upload.py你会看到日志不断滚动，每30秒上报一次数据。
更优雅的方式：用cron定时执行
上面的无限循环方式简单直观，但有个缺点：一旦程序崩溃，就得手动重启。
更稳健的做法是使用Linux系统的crontab定时任务机制，让它自动定期执行脚本。
设置cron任务
编辑定时任务：
crontab -e添加一行：
*/30 * * * * /usr/bin/python3 /home/pi/sensor_upload.py >> /home/pi/upload.log 2>&1含义：每30分钟执行一次脚本，并把输出追加到日志文件中。
📌 优点：
- 即使某次执行失败，下一轮仍会继续；
- 不占用常驻内存；
- 易于与其他服务集成。
服务器那边要做什么？
你可能会问：“我树莓派发出去了，那服务器该怎么收？”
这里给个极简的 Flask 示例，帮你快速验证连通性。
Python Flask接收端（示例）
from flask import Flask, request import json app = Flask(__name__) @app.route('/api/sensor', methods=['POST']) def receive_data(): data = request.get_json() print(f"📩 收到新数据: {data}") # 这里可以存入数据库 return {'status': 'ok'}, 200 if __name__ == '__main__': app.run(host='0.0.0.0', port=80)部署后，确保防火墙开放80端口，树莓派就能访问到了。
🔐 提示：公网暴露服务有风险，测试完建议关闭或加身份验证（如Token校验）。
教学中的常见问题与避坑指南
我在指导学生做这个项目时，发现以下几个“高频翻车点”，提前告诉你，帮你绕过去：
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 📉 传感器总是读失败 | 没加上拉电阻 / 电源不稳 | 加10kΩ上拉电阻，换高质量电源 |
| 🌐 上传时报“Connection refused” | 服务器IP不通 / 防火墙拦截 | 用curl测试能否访问目标URL |
| 🕒 时间戳乱七八糟 | 树莓派未同步时间 | 安装ntp服务自动校时 |
| 🔐 密钥写在代码里被提交Git | 缺乏安全意识 | 改用环境变量或配置文件 |
| 💤 CPU占用过高 | 循环间隔太短（<2秒） | DHT22最多每秒采样一次 |
特别是最后一点：不要频繁读取DHT22！它的硬件限制决定了最快1秒才能更新一次数据，强行高频读取只会增加失败概率。
这个项目还能怎么升级？
完成了基础功能之后，你可以考虑以下几个方向进行拓展，让你的课程设计脱颖而出：
✅ 加分项1：本地缓存 + 断网重传
当网络中断时，把数据暂存本地文件或SQLite数据库，恢复后再补传。
✅ 加分项2：加入HTTPS加密
把HTTP换成HTTPS，提升安全性，顺便学习证书配置。
✅ 加分项3：对接云平台
改用阿里云IoT、腾讯云IoT Hub等平台，使用MQTT协议实现双向通信。
✅ 加分项4：可视化仪表盘
用Grafana + InfluxDB搭建实时监控面板，配上趋势图和报警规则。
✅ 加分项5：多传感器融合
除了温湿度，再接入光照、PM2.5、噪声等传感器，打造多功能环境站。
写在最后：这不是作业，是通往工程师的第一步
当你第一次看到自己的树莓派在无人干预的情况下，准时准点地把一条条温湿度数据发送到服务器，那一刻的感觉，和单纯点亮LED完全不同。
你不再只是“控制硬件”，而是构建了一个会思考、会表达、能联网的生命体。
而这，正是现代嵌入式工程师的核心能力：软硬协同、系统集成、数据驱动。
所以，别满足于“做完就行”。把这个项目当作种子，种下更多可能性。也许下次，你要上传的就是空气质量预警、土壤湿度告警，甚至是实验室门禁日志。
技术的意义，从来不只是完成任务，而是让你有能力去改变现实。
如果你正在做课程设计，欢迎把你的实现思路或遇到的问题发在评论区，我们一起讨论优化。
