ESP8266 OTA升级报‘empty esp_tls parameter’错误求助

核心原因 #

1. 协议与端口不匹配：你使用了HTTPS协议的URL（https://），但手动指定了HTTP的默认端口80。HTTPS的默认端口是443，这种不匹配会导致ESP-TLS模块在初始化SSL连接时内部逻辑出错，无法正确创建esp_tls结构体，从而触发"empty esp_tls parameter"错误。

2. 证书配置问题（潜在诱因）：如果server_cert_pem_start指向的证书无效、格式错误，或者未正确包含进工程，也会导致TLS初始化失败，间接引发该参数为空的错误。

修复步骤 #

• 修正端口配置：
  要么删除.port = 80字段，让ESP-HTTP客户端自动根据URL协议选择默认端口；要么明确将端口改为443。修改后的配置示例：

  esp_http_client_config_t ota_config = {
      .url = "https://www.website.com/get-firmware",
      .cert_pem = (char *)server_cert_pem_start,
      .event_handler = _http_event_handler,
      .auth_type = HTTP_AUTH_TYPE_NONE
      // 移除.port配置，或改为.port = 443
  };
  

• 验证证书有效性：
  确认server_cert_pem_start对应的PEM格式证书是目标服务器的可信证书（可通过浏览器导出服务器的根证书）。如果仅用于调试，可临时添加.skip_cert_common_name_check = true跳过证书校验（生产环境绝对禁止此操作）。

• 检查任务栈大小：
  当前OTA任务栈大小为8192字节，若你的_http_event_handler有额外逻辑，可尝试增大栈到16384字节，避免栈溢出导致的内存异常（栈溢出可能引发各种非直观的参数错误）：

  xTaskCreate(&simple_ota_example_task, "ota_example_task", 16384, NULL, 5, NULL);
  

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