Desempenho¶
Configuração do Benchmark¶
Todos os dados foram coletados executando 100 requisições HTTP GET consecutivas com uma carga JSON em um dispositivo ESP32 real contra o endpoint público /users do JSONPlaceholder. Ambas as bibliotecas foram configuradas com as definições padrão. A conexão WiFi já estava estabelecida antes do início do teste.
Resultados¶
| Métrica / Recurso | Padrão (HTTPClient + ArduinoJson) | ESP32-HTTP-Client | Comparação |
|---|---|---|---|
| Alocação de heap por requisição | ~58.2 KB | ~15 bytes | ⬇ ~99.9% menos RAM |
| Pegada média de RAM | 34.2% | 24.3% | ⬇ ~29% menos no geral |
| Heap livre mínima | 114.3 KB | 128.6 KB | ⬆ Margem mais segura |
| Tempo médio de execução | ~750 ms | ~59 ms | 🚀 ~12× mais rápido |
| Verbosidade do código | ~15 linhas de boilerplate | 1 cadeia fluente | ⬇ Limpo & legível |
| Análise de JSON | deserializeJson() |
Automático, vinculação direta | ⬆ Sem alocação de documento |
Por que é tanto mais rápido?¶
HTTP Keep-Alive¶
O ESP32HTTPClient habilita o HTTP/1.1 Keep-Alive por padrão através de _http.setReuse(true). Isso permite que a conexão TCP/TLS subjacente seja reutilizada em múltiplas requisições para o mesmo servidor.
A abordagem padrão normalmente fecha e reabre a conexão a cada chamada, pagando o custo total do handshake TLS (~700–800 ms em uma rede WiFi típica) toda vez.
Análise de Fluxo com Cópia Zero (Zero-Copy Stream Parsing)¶
Em vez de chamar http.getString() (que aloca a resposta inteira na memória heap) e depois passá-la para deserializeJson() (que aloca um DynamicJsonDocument), esta biblioteca:
- Obtém um ponteiro bruto
Stream*diretamente doHTTPClient. - Analisa o fluxo JSON byte a byte através do
BufferedStreamReader. - Grava os valores correspondentes diretamente nas suas variáveis C pré-declaradas.
O corpo completo da resposta nunca é armazenado na memória. A alocação total de heap para uma resposta típica é de ~15 bytes de estado interno.
Decodificação Chunked (Chunked Transfer Encoding)¶
APIs modernas frequentemente respondem com Transfer-Encoding: chunked. O BufferedStreamReader da biblioteca decodifica automaticamente respostas em chunks sem exigir que a carga útil completa seja armazenada em buffer primeiro.
Compensações de Memória e Ciclo de Vida do Heap TLS¶
| Cenário | Heap alocado durante a requisição | RAM liberada por end() |
|---|---|---|
Conexão HTTP simples (http://) |
~15 bytes | ~5–10 KB buffers de socket |
TLS sem configuração (https:// padrão) |
Padrão do core | Padrão do core |
TLS configurado (setCACert, bundle, etc.) |
~45 KB (buffers mbedTLS) | ~45 KB (contexto TLS + buffers de registro) |
Alocação de TLS Sob Demanda (Lazy Allocation)¶
O ESP32HTTPClient aloca os recursos seguros sob demanda. O cliente seguro interno não é instanciado na construção do objeto. Projetos que se comunicam exclusivamente via http:// têm zero overhead de heap para TLS.
Quando uma conexão https:// é aberta:
1. Handshake Inicial: O mbedTLS aloca contextos SSL internos e buffers de registro TX/RX (~45 KB).
2. Reaproveitamento de Sessão (Keep-Alive): Requisições consecutivas para o mesmo servidor reutilizam a sessão TLS existente sem alocações adicionais de memória, executando até 12× mais rápido.
3. Liberação de Memória TLS: Chamar client.end() encerra a sessão TLS, fecha o socket e devolve os ~45 KB de buffers mbedTLS para a heap livre. Requisições posteriores restabelecerão a conexão automaticamente se necessário.
Chame client.end() após uma rajada de requisições se o seu sketch entrar em um longo período de inatividade:
// Rajada de requisições
for (int i = 0; i < 10; i++) {
client.get("/data").getBody("v", &val);
// ... processar val
}
client.end(); // libera ~45KB de buffers TLS
delay(60 * 1000); // aguarda 1 minuto
Código-Fonte do Benchmark¶
Os sketches de benchmark completos e scripts de comparação estão no diretório bench/ do repositório.