单片机与物联网 / 系统课时
发送 HTTP 请求
发送 HTTP 请求
ESP32 连上 Wi-Fi 后,可以像普通客户端一样访问远程 HTTP 接口。本节用一个完整示例完成 GET 与 POST,请求后同时检查状态码、读取响应体,并处理连接失败和超时。
学习目标
- 使用
HTTPClient发起 GET 与 POST 请求 - 根据 HTTP 状态码判断请求是否成功,并读取响应数据
- 正确释放连接资源,识别超时、断网和服务端错误
请求链路和准备
一次请求至少会经过 ESP32、无线网络和远程 HTTP 服务。程序先确认 Wi-Fi 已连接,再创建客户端、发送请求、读取响应,最后调用 end() 释放本次 HTTP 会话占用的资源。

下面示例使用 ESP32 Arduino Core 自带的 WiFi.h、HTTPClient.h 和 WiFiClient.h。把 Wi-Fi 名称与密码替换为实际值;示例接口使用 http://httpbin.org,运行环境需要能访问互联网。
同时发送 GET 与 POST
主程序先连接 Wi-Fi,然后分别调用两个函数。GET 把设备名放在查询参数中;POST 发送 JSON,并通过 Content-Type 告诉服务端正文格式。
cpp
#include <WiFi.h>
#include <WiFiClient.h>
#include <HTTPClient.h>
const char* WIFI_SSID = "<SSID>";
const char* WIFI_PASSWORD = "<PASSWORD>";
void sendGet() {
WiFiClient client;
HTTPClient http;
const char* url = "http://httpbin.org/get?device=esp32";
if (!http.begin(client, url)) {
Serial.println("GET begin failed");
return;
}
http.setTimeout(5000);
int status = http.GET();
if (status > 0) {
Serial.printf("GET status: %d\n", status);
String body = http.getString();
Serial.println("GET body:");
Serial.println(body);
} else {
Serial.printf("GET error: %s\n",
HTTPClient::errorToString(status).c_str());
}
http.end();
}
void sendPost() {
WiFiClient client;
HTTPClient http;
const char* url = "http://httpbin.org/post";
if (!http.begin(client, url)) {
Serial.println("POST begin failed");
return;
}
http.setTimeout(5000);
http.addHeader("Content-Type", "application/json");
String requestBody = R"({"device":"esp32","value":42})";
int status = http.POST(requestBody);
if (status > 0) {
Serial.printf("POST status: %d\n", status);
String body = http.getString();
Serial.println("POST body:");
Serial.println(body);
} else {
Serial.printf("POST error: %s\n",
HTTPClient::errorToString(status).c_str());
}
http.end();
}
void setup() {
Serial.begin(115200);
WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
unsigned long startedAt = millis();
while (WiFi.status() != WL_CONNECTED &&
millis() - startedAt < 20000) {
delay(500);
Serial.print(".");
}
if (WiFi.status() != WL_CONNECTED) {
Serial.println("\nWi-Fi connect failed");
return;
}
Serial.println("\nWi-Fi connected");
sendGet();
sendPost();
}
void loop() {
}预期输出
text
Wi-Fi connected
GET status: 200
GET body:
{
"args": {
"device": "esp32"
},
"headers": <VALUE>,
"origin": "<IP>",
"url": "http://httpbin.org/get?device=esp32"
}
POST status: 200
POST body:
{
"args": {},
"data": "{\"device\":\"esp32\",\"value\":42}",
"json": {
"device": "esp32",
"value": 42
},
"headers": <VALUE>,
"origin": "<IP>",
"url": "http://httpbin.org/post"
}<IP>、请求头和服务端补充字段会随网络与接口实现变化。判断成功时不要只看响应体:先检查 status 是否在预期范围内,再解析正文;例如 404、500 仍然可能返回可读的错误正文。
处理失败与生产环境边界
当 status <= 0 时,错误发生在 HTTP 传输层,例如连接失败或超时,此时 HTTPClient::errorToString() 比直接打印负数更容易定位问题。若 Wi-Fi 已断开,应先恢复网络,再发起新请求,而不是持续重试同一个会话。
示例为了聚焦 HTTP 流程使用明文 HTTP。真实设备传输账号、令牌或业务数据时应改用 HTTPS,并配置可验证的服务端证书或 CA 信任链;不要把“忽略证书校验”当作长期方案。
按自己的节奏,确认真正理解。