Tag: httpclient

O Refit 16.1.0 permite que um método de interface retorne PagedEnumerable<TPage, TItem>, e o gerador de código-fonte emite o loop de uma requisição por página para cursores, offsets, cabeçalhos de resposta e links de próxima página. Veja como declará-lo, como a enumeração se comporta, e o erro de build RF013 que você recebe para um membro com nome errado.

O HttpClient reutiliza uma conexão keep-alive que o servidor acabou de fechar, ou o servidor derruba a conexão no meio da resposta. Reduza o PooledConnectionIdleTimeout para abaixo do tempo limite de ociosidade do servidor e repita apenas requisições idempotentes.

Um DelegatingHandler registrado antes de AddStandardResilienceHandler roda uma vez por requisição lógica, não uma vez por retry. Mova-o para depois do resilience handler e torne-o idempotente, porque o retry reenvia o mesmo HttpRequestMessage. Medido com Microsoft.Extensions.Http.Resilience 10.10.0 e 8.10.0.

A BCL não tem um tipo ProblemDetails, e adicionar um FrameworkReference para Microsoft.AspNetCore.App faz seu cliente se recusar a iniciar em um contêiner que só traz o runtime. Aqui está o modelo de 20 linhas que resolve, o DelegatingHandler que transforma problem+json em uma exceção tipada, e o mito do content-type que quase toda resposta ainda repete.

O AddServiceDefaults do Aspire aplica um manipulador de resiliência padrão a todo HttpClient. Chamar AddStandardResilienceHandler de novo empilha um segundo manipulador em vez de substituí-lo. Aqui estão os três caminhos reais de sobrescrita, o nome de opções -standard que ninguém documenta e o timeout infinito que você herda se apenas removê-lo.

A AuthenticationException interna informa a causa real: uma cadeia não confiável, um nome que não corresponde ou uma diferença de versão do TLS. Confie no certificado, corrija o host ou alinhe os protocolos. Não desative a validação por completo.

Use o resilience handler do Microsoft.Extensions.Http.Resilience para chamadas com HttpClient, pois ele é o Polly com padrões que entendem HTTP e telemetria em uma única linha. Recorra ao ResiliencePipeline do Polly diretamente apenas quando proteger algo que não seja um HttpClient.

Nunca crie um HttpClient por requisição. Use IHttpClientFactory para gerenciar o ciclo de vida e adicione Refit por cima quando quiser uma interface tipada em vez de escrever o código de requisição na mão. Um HttpClient singleton puro só serve para os casos mais simples.

O HttpClient lança TaskCanceledException por três motivos diferentes: timeout, cancelamento pelo chamador ou um aborto em nível de conexão. Diferencie-os com InnerException e CancellationToken.IsCancellationRequested e corrija o motivo certo.

Um guia completo para testar HttpClient no .NET 11: por que você não deve mockar HttpClient diretamente, como escrever um HttpMessageHandler de stub, trocar o handler primário com IHttpClientFactory, verificar retentativas do Polly e a opção WireMock.Net.