O teste do webhook passou pelo motivo errado: Http::fake não intercepta curl direto
[!NOTE] Resumo Executivo (DEV-2026-121): O teste de webhook com erro passou, enquanto o de sucesso falhou. O model usava curl direto, então a simulação não valia e o teste tentava sair para a rede de verdade.
🚨 O Desafio Técnico / Contexto
Http::fake só intercepta o cliente HTTP do Laravel, e o model chamava curl_init. O teste de erro passava porque a conexão a um domínio inexistente falhava de verdade. Uma resposta HTTP 500 também gerava mensagem de erro vazia, porque curl_error só informa falha de conexão.
💡 Principais Lições Aprendidas & Descobertas
- 💡 Um teste de falha pode passar por qualquer falha. Confira também o motivo, por exemplo se a mensagem contém HTTP 500.
- 💡 Trocar curl pelo cliente do Laravel torna o código testável sem rede e leva o motivo do erro para o registro.
- 💡 O teste de sucesso é o controle: ele mostrou que a simulação não estava valendo.
- 💡 Http::failedConnection e exceção lançada dentro de Http::fake derrubaram o PHP 8.3 com falha de segmentação com o Xdebug no modo develop. Para simular conexão recusada, uma porta local fechada funciona sem simulação.
- 💡 Falha de segmentação não deixa relatório do teste: exit 139 e saída vazia. Rode os testes um a um para isolar o culpado.
🛠️ Especificação Técnica & Código-Chave
try {
$response = Http::withHeaders($this->headers ?? [])
->timeout($this->timeout)
->send($this->method, $this->url, ['json' => $payload]);
} catch (ConnectionException $e) {
return ['success' => false, 'error' => $e->getMessage()];
}
📈 Impacto no Ecossistema & Valor Prático
Os testes de webhook passaram a provar o resultado sem depender da rede, e a falha grava o motivo.
- Projetos Relacionados:
sistema-de-atendimento - Registro de Origem:
_data/daily.dev-19.yml
Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.