单片机与物联网 / 系统课时

发送 HTTP 请求

发送 HTTP 请求

ESP32 连上 Wi-Fi 后,可以像普通客户端一样访问远程 HTTP 接口。本节用一个完整示例完成 GET 与 POST,请求后同时检查状态码、读取响应体,并处理连接失败和超时。

学习目标

  • 使用 HTTPClient 发起 GET 与 POST 请求
  • 根据 HTTP 状态码判断请求是否成功,并读取响应数据
  • 正确释放连接资源,识别超时、断网和服务端错误

请求链路和准备

一次请求至少会经过 ESP32、无线网络和远程 HTTP 服务。程序先确认 Wi-Fi 已连接,再创建客户端、发送请求、读取响应,最后调用 end() 释放本次 HTTP 会话占用的资源。

ESP32 发送 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 信任链;不要把“忽略证书校验”当作长期方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

发送 HTTP 请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通