NodeMCU ESP8266编译错误：HTTPClient::begin过时API问题求解

问题分析 #

编译错误提示call to 'HTTPClient::begin' declared with attribute error: obsolete API, use ::begin(WiFiClient, url)，核心原因是使用了HTTPClient已废弃的单参数begin方法，同时代码还存在语法、逻辑冗余等小问题，以下是完整修复方案：

关键修改点 #

• 替换过时的begin调用：原代码http.begin("LinkGet")存在两个问题——使用了废弃API，且错误地将变量名包裹成字符串字面量。需改为http.begin(wifiClient, LinkGet)，使用带WiFiClient参数的重载版本。
• 清理重复头文件：删除重复包含的ESP8266WiFi.h、WiFiClient.h、ESP8266HTTPClient.h，减少编译冗余。
• 适配HTTPS连接：若目标服务器用HTTPS，需用WiFiClientSecure替代WiFiClient；本地测试建议改用HTTP协议（将host改为http://localhost/），跳过SSL证书验证的复杂步骤。
• 修正LED注释逻辑：原代码中LED开关的注释与实际逻辑相反，已同步修正。

修复后的完整代码 #

// 引入必要库
#include <ESP8266WiFi.h>
#include <WiFiClient.h>
#include <ESP8266HTTPClient.h>
#include <ESP8266WebServer.h>
#include <WiFiClientSecureBearSSL.h>

// 引脚定义
#define ON_Board_LED 2  // 板载LED（GPIO2 = D4），用于WiFi连接状态指示
#define LED_D8 15        // 外部LED引脚（D8 = GPIO15）

// WiFi配置
const char* ssid = "*wifi name*";     // WiFi名称
const char* password = "*Wfif password*"; // WiFi密码

// 服务器地址（本地测试建议用HTTP，避免HTTPS证书问题）
const char *host = "http://localhost/";

void setup() {
  Serial.begin(115200);
  delay(500);

  WiFi.mode(WIFI_STA);
  WiFi.begin(ssid, password);
  Serial.println("");
    
  pinMode(ON_Board_LED, OUTPUT);
  digitalWrite(ON_Board_LED, HIGH); // 关闭板载LED

  pinMode(LED_D8, OUTPUT);
  digitalWrite(LED_D8, LOW); // 关闭外部LED

  // 等待WiFi连接
  Serial.print("Connecting");
  while (WiFi.status() != WL_CONNECTED) {
    Serial.print(".");
    // 板载LED闪烁提示连接中
    digitalWrite(ON_Board_LED, LOW);
    delay(250);
    digitalWrite(ON_Board_LED, HIGH);
    delay(250);
  }

  digitalWrite(ON_Board_LED, HIGH); // 连接成功后关闭板载LED
  // 输出连接信息
  Serial.println("");
  Serial.print("Successfully connected to : ");
  Serial.println(ssid);
  Serial.print("IP address: ");
  Serial.println(WiFi.localIP());
  Serial.println();
}

void loop() {
  HTTPClient http;
  WiFiClient wifiClient; // 若用HTTPS，替换为WiFiClientSecure wifiClient;

  // 构建请求链接
  String GetAddress = "rafael/GetData.php"; 
  String LinkGet = host + GetAddress;
  String getData = "ID=" + String(0); // 查询ID=0的LED状态

  Serial.println("----------------Connect to Server-----------------");
  Serial.println("Get LED Status from Server or Database");
  Serial.print("Request Link : ");
  Serial.println(LinkGet);

  // 使用支持的begin方法初始化请求
  http.begin(wifiClient, LinkGet);
  http.addHeader("Content-Type", "application/x-www-form-urlencoded");
  
  // 发送POST请求
  int httpCodeGet = http.POST(getData);
  String payloadGet = http.getString();

  // 输出请求结果
  Serial.print("Response Code : ");
  Serial.println(httpCodeGet);
  Serial.print("Returned data from Server : ");
  Serial.println(payloadGet);

  // 根据返回值控制LED
  if (payloadGet == "1") {
    digitalWrite(LED_D8, HIGH); // 打开LED
  }
  if (payloadGet == "0") {
    digitalWrite(LED_D8, LOW); // 关闭LED
  }

  // 关闭连接
  Serial.println("----------------Closing Connection----------------");
  http.end();
  Serial.println();
  Serial.println("Please wait 5 seconds for the next connection.");
  Serial.println();
  delay(5000); // 每5秒查询一次
}

额外说明 #

如果必须使用HTTPS连接，需将WiFiClient wifiClient;替换为WiFiClientSecure wifiClient;，并可临时关闭证书验证（添加wifiClient.setInsecure();）以适配本地自签名证书场景。

内容的提问来源于stack exchange，提问作者Jarl Malte Edwin LYCKOSKOLD