使用ESP32-S3调用HTTPS Web API端点遇阻，求解决方案

一、HTTP库选择建议 #

直接使用ESP32官方Arduino核心自带的HTTPClient.h，理由如下：

• 专为ESP32优化，内置HTTPS支持，无需额外配置SSL库
• 社区文档完善，问题排查资源充足
• 用法简洁，性能稳定，是ESP32网络请求的首选

另外两个库的定位：

• HttpClient.h：基础第三方HTTP库，不支持HTTPS，仅适用于简单HTTP请求场景
• ArduinoHttpClient.h：第三方库，HTTPS支持需手动搭配SSL客户端，适配性远不如官方库

二、HTTPS请求失败（状态码-2/-3）的解决方法 #

你遇到的状态码-2（连接失败）、-3（SSL握手失败），核心原因是使用了不支持SSL的WiFiClient，且ArduinoHttpClient.h的HTTPS配置繁琐。换成官方HTTPClient.h+WiFiClientSecure即可解决，代码示例：

#include <WiFi.h>
#include <HTTPClient.h>
#include <WiFiClientSecure.h>

const char* ssid = "你的WiFi名称";
const char* password = "你的WiFi密码";
const char* apiUrl = "https://httpbin.org/get";

// 初始化支持SSL的客户端用于HTTPS请求
WiFiClientSecure wifiClient;

void setup() {
  Serial.begin(115200);
  
  // 连接WiFi
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println("\nWiFi连接成功");

  // 禁用证书验证（仅测试用，生产环境建议添加目标网站根证书）
  wifiClient.setInsecure();
}

void loop() {
  if (WiFi.status() == WL_CONNECTED) {
    HTTPClient http;

    // 初始化HTTPS请求
    if (http.begin(wifiClient, apiUrl)) {
      int httpCode = http.GET();

      // 处理响应
      if (httpCode > 0) {
        Serial.printf("状态码: %d\n", httpCode);
        if (httpCode == HTTP_CODE_OK) {
          String payload = http.getString();
          Serial.println("响应内容:");
          Serial.println(payload);
          // 此处可添加JSON解析逻辑，推荐使用ArduinoJson库
        }
      } else {
        Serial.printf("请求失败，错误码: %d\n", httpCode);
      }

      http.end(); // 释放HTTP资源
    } else {
      Serial.println("无法初始化HTTP连接");
    }
  }
  
  delay(5000); // 每隔5秒发起一次请求
}

关键说明 #

1. WiFiClientSecure：ESP32专门用于HTTPS请求的客户端，替代普通的WiFiClient
2. setInsecure()：测试阶段可临时禁用证书验证，生产环境务必添加目标网站的根证书，避免安全风险
3. JSON解析：若需解析返回的JSON数据，推荐使用ArduinoJson库，在PlatformIO的platformio.ini中添加lib_deps = bblanchon/ArduinoJson @ ^6.21.3即可安装使用

内容的提问来源于stack exchange，提问作者nlv