HTTP

[English]


ESP8266 ⽀持 HTTP 服务端吗?

⽀持。ESP8266 在 SoftAP 和 Station 模式下都可以作服务端。

  • 在 SoftAP 模式下,ESP8266 的服务端 IP 地址是 192.168.4.1。

  • 如果 Station 模式,服务端的 IP 地址为路由器分配给 ESP8266 的 IP。

  • 如果基于 SDK 进行⼆次开发,可参考相关应用示例。

  • 如果使⽤ AT 指令,需使⽤ AT+CIPSERVER 开启服务端。


如何使用 esp_http_client 发送块 (chunked) 数据?

  • 可以通过 HTTP Stream 的方式,将 esp_http_client_open()write_len 参数设置为 -1,代码中会自动将 Transfer-Encoding 设置为 chunked,参考 esp_http_client.c 中的 http_client_prepare_first_line()

  • 可使用如下代码:

    static void http_post_chunked_data()
    {
        esp_http_client_config_t config = {
        .url = "http://httpbin.org/post",
        .method = HTTP_METHOD_POST, // This is NOT required. write_len < 0 will force POST anyway
      };
      char buffer[MAX_HTTP_OUTPUT_BUFFER] = {0};
      esp_http_client_handle_t client = esp_http_client_init(&config);
    
      esp_err_t err = esp_http_client_open(client, -1); // write_len=-1 sets header "Transfer-Encoding: chunked" and method to POST
      if (err != ESP_OK) {
        ESP_LOGE(TAG, "Failed to open HTTP connection: %s", esp_err_to_name(err));
        return;
      }
    
      // Post some data
      esp_http_client_write(client, "5", 1); // length
      esp_http_client_write(client, "\r\n", 2);
      esp_http_client_write(client, "Hello", 5); // data
      esp_http_client_write(client, "\r\n", 2);
      esp_http_client_write(client, "7", 1); // length
      esp_http_client_write(client, "\r\n", 2);
      esp_http_client_write(client, " World!", 7);  // data
      esp_http_client_write(client, "\r\n", 2);
      esp_http_client_write(client, "0", 1);  // end
      esp_http_client_write(client, "\r\n", 2);
      esp_http_client_write(client, "\r\n", 2);
    
    
      // After the POST is complete, you can examine the response as required using:
      int content_length = esp_http_client_fetch_headers(client);
      ESP_LOGI(TAG, "content_length: %d, status_code: %d", content_length, esp_http_client_get_status_code(client));
    
      int read_len = esp_http_client_read(client, buffer, 1024);
      ESP_LOGI(TAG, "receive %d data from server: %s", read_len, buffer);
      esp_http_client_close(client);
      esp_http_client_cleanup(client);
    }
    


ESP32 作为 HTTP 服务器时,如何设置可同时连接的客户端个数上限?如果客户端连接个数超出上限,会出现怎样的情况?

  • 通过配置 httpd_config_t 结构体里的 max_open_sockets 即可设置同时连接的客户端最大个数。

  • 如果存在客户端连接个数超出上限的情况,可以把 httpd_config_t 结构体里的 lru_purge_enable 参数设置为 true。这个参数设置为 true 的作用是如果没有可用的套接字(这个套接字由 max_open_sockets 决定),就会清除最少使用的那个套接字从而接受最新的套接字。


ESP32 是否有至少在 HTTP/2 上实现 gRPC 客户端的示例?

目前还没有。


在 ESP-IDF 中,如何通过 HTTP 下载文件里的某一特定段(即在头部添加 Range:bytes 信息)?

可以参考 esp http client 示例 里的 http_partial_download 函数。


ESP 模块作为本地 HTTP/HTTPS Server,浏览器端访问时会返回 Header fields are too long for server to interpret 错误如何解决?

  • 出现这个问题的原因是浏览器端 URL 过长,而底层 buffer 分配的长度不够,这部分可以通过修改 menuconfig 的配置来增大 HTTP 头部长度,默认是 512 字节,可以将其调整为更大的数据,比如 1024 字节,具体操作步骤如下:

    • idf.py menuconfig > Component config > HTTP Server > (1024)Max HTTP Request Header Length

    • idf.py menuconfig > Component config > HTTP Server > (1024)Max HTTP URI Length


HTTP request 返回 “HTTP_HEADER: Buffer length is small to fit all the headers” 错误如何解决?

  • 请将 esp-idf/components/esp_http_client/include/esp_http_client.h 文件中的 esp_http_client_config_t 结构体里的成员变量 buffer_size_tx 调整为 1024 字节或更大。


执行 esp_http_client_perform 函数后,为何调用 esp_http_client_read_response 读取的数据长度总是为 0?

esp_http_client_perform 函数已包含数据读取操作,因此在其执行后不应再调用 esp_http_client_read_response。若需获取数据,应在事件处理程序中处理 HTTP_EVENT_ON_DATA 事件。