System.Net.Http.HttpRequestException: Response status code does not indicate success: 404 (Not Found).
Serverul a răspuns, dar cu un cod de eroare (aici 404, resursa nu există), iar `EnsureSuccessStatusCode()` sau `GetStringAsync()` a transformat răspunsul în excepție. Verifică adresa și parametrii cererii sau tratează explicit codurile de eroare cu `IsSuccessStatusCode`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Orice răspuns HTTP are un cod de stare: 2xx înseamnă succes, 4xx o problemă a cererii (404 Not Found, 401 Unauthorized, 400 Bad Request), 5xx o problemă a serverului (500 Internal Server Error, 503 Service Unavailable). HttpClient.GetAsync întoarce răspunsul indiferent de cod; abia EnsureSuccessStatusCode() aruncă HttpRequestException dacă acesta nu e 2xx. GetStringAsync și GetFromJsonAsync fac verificarea automat.
Mesajul conține codul și textul lui. Ce înseamnă cele mai frecvente:
- 404: adresa e greșită (un
/lipsă, un id inexistent, o versiune de API greșită); - 401 / 403: lipsește tokenul sau cheia API, ori nu ai drepturi;
- 400: corpul cererii nu e valid (JSON greșit, câmpuri lipsă);
- 500: eroare pe server; conținutul răspunsului poate avea detalii.
Din .NET 5, excepția are proprietatea StatusCode, deci o poți trata după cod: catch (HttpRequestException ex) when (ex.StatusCode == HttpStatusCode.NotFound).
De ce apare: cauzele frecvente
1EnsureSuccessStatusCode pe o resursă care poate lipsi
var r = await client.GetAsync($"produse/{id}");
r.EnsureSuccessStatusCode();var r = await client.GetAsync($"produse/{id}");
if (!r.IsSuccessStatusCode)
{
Console.WriteLine($"Eroare {(int)r.StatusCode}");
return;
}Când 404 e un rezultat posibil (un produs șters), tratează-l ca pe un caz normal, nu ca excepție.
2Adresă construită greșit
client.BaseAddress = new Uri("https://api.magazin.ro/v1");
var r = await client.GetAsync("/produse");client.BaseAddress = new Uri("https://api.magazin.ro/v1/");
var r = await client.GetAsync("produse");Cu / la începutul căii relative, partea /v1 din BaseAddress se pierde. BaseAddress se termină cu /, iar calea relativă începe fără /.
3Lipsește autentificarea (401)
var json = await client.GetStringAsync("comenzi");client.DefaultRequestHeaders.Authorization =
new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token);
var json = await client.GetStringAsync("comenzi");Pentru API-urile protejate, cererea trebuie să conțină tokenul sau cheia cerută de documentație.
Repară eroarea, direct în pagină
Programul cere de la un API (simulat local de ServerFals) produsele cu id 7 și 999. Produsul 999 nu există, iar programul se oprește cu System.Net.Http.HttpRequestException: Response status code does not indicate success: 404 (Not Found). Tratează codul de eroare ca programul să afișeze Produsul 999 nu exista (404).
using System.Net;
var client = new HttpClient(new ServerFals()) { BaseAddress = new Uri("https://api.magazin.ro/") };
foreach (string id in new[] { "7", "999" })
{
var raspuns = await client.GetAsync($"produse/{id}");
raspuns.EnsureSuccessStatusCode();
Console.WriteLine(await raspuns.Content.ReadAsStringAsync());
}
class ServerFals : HttpMessageHandler
{
protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage cerere, CancellationToken token)
{
var cod = cerere.RequestUri.AbsolutePath.EndsWith("/7") ? HttpStatusCode.OK : HttpStatusCode.NotFound;
var raspuns = new HttpResponseMessage(cod) { Content = new StringContent("{\"Nume\":\"Mouse\"}") };
return Task.FromResult(raspuns);
}
}{"Nume":"Mouse"}
Produsul 999 nu exista (404)Indiciu
Înlocuiește EnsureSuccessStatusCode() cu un if (raspuns.IsSuccessStatusCode) și afișează (int)raspuns.StatusCode pe ramura de eroare.
Reparația
using System.Net;
var client = new HttpClient(new ServerFals()) { BaseAddress = new Uri("https://api.magazin.ro/") };
foreach (string id in new[] { "7", "999" })
{
var raspuns = await client.GetAsync($"produse/{id}");
if (raspuns.IsSuccessStatusCode)
Console.WriteLine(await raspuns.Content.ReadAsStringAsync());
else
Console.WriteLine($"Produsul {id} nu exista ({(int)raspuns.StatusCode})");
}
class ServerFals : HttpMessageHandler
{
protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage cerere, CancellationToken token)
{
var cod = cerere.RequestUri.AbsolutePath.EndsWith("/7") ? HttpStatusCode.OK : HttpStatusCode.NotFound;
var raspuns = new HttpResponseMessage(cod) { Content = new StringContent("{\"Nume\":\"Mouse\"}") };
return Task.FromResult(raspuns);
}
}De ce merge
EnsureSuccessStatusCode() transforma răspunsul 404 în excepție și oprea bucla. Cu IsSuccessStatusCode, programul verifică singur codul: pentru 7 citește și afișează conținutul JSON, iar pentru 999 afișează un mesaj cu codul numeric obținut din StatusCode. Un produs inexistent devine astfel un rezultat tratat, nu o eroare.
Alte forme ale mesajului
System.Net.Http.HttpRequestException: Response status code does not indicate success: 401 (Unauthorized).System.Net.Http.HttpRequestException: Response status code does not indicate success: 500 (Internal Server Error).
Cum o eviți pe viitor
- Afișează în log adresa completă a cererii și codul răspunsului; de obicei problema se vede imediat.
- Folosește
IsSuccessStatusCodecând codurile de eroare sunt rezultate așteptate șiEnsureSuccessStatusCodecând nu sunt. - Prinde excepția cu filtru după cod:
catch (HttpRequestException ex) when (ex.StatusCode == HttpStatusCode.NotFound). - La 4xx și 5xx citește și conținutul răspunsului: API-urile pun acolo mesajul de eroare.
- Încearcă cererea separat (în browser sau cu un client HTTP) ca să vezi dacă problema e în cod sau în server.
Întrebări frecvente
De ce GetAsync nu aruncă excepție la 404, dar GetStringAsync aruncă?
GetAsync întoarce răspunsul complet, cu cod cu tot, și te lasă pe tine să decizi. GetStringAsync vrea doar conținutul, deci verifică automat codul și aruncă excepție dacă nu e de succes.
HttpRequestException apare și fără cod de stare. Ce înseamnă?
Atunci cererea n-a ajuns la server: DNS greșit (No such host is known), server oprit (Connection refused), probleme de certificat. ex.StatusCode e null în aceste cazuri, iar mesajul și excepția interioară spun cauza.
Erori înrudite
System.InvalidOperationException: An invalid request URI was provided. Either the request URI must be an absolute URI or BaseAddress must be set. Ai trimis o cerere cu `HttpClient` folosind o cale relativă (`"api/produse"`), dar clientul nu are `BaseAddress`. Setează `client.BaseAddress = new Uri("https://api.magazin.ro/");` sau folosește adresa completă în cerere. System.Threading.Tasks.TaskCanceledException: A task was canceled. O operație asincronă a fost anulată printr-un `CancellationToken` (de utilizator, de un timeout cu `CancelAfter` sau de `HttpClient.Timeout`) și nu ai tratat anularea. Prinde `OperationCanceledException` acolo unde anularea e un caz normal sau mărește timeout-ul dacă operația chiar are nevoie de mai mult timp. System.Text.Json.JsonException: '<' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0. Textul dat lui `JsonSerializer.Deserialize` nu este JSON valid. Caracterul dintre apostrofuri e primul lucru greșit: `'<'` înseamnă de obicei că ai primit o pagină HTML (o eroare a serverului), iar `'''` că valorile sunt între apostrofuri în loc de ghilimele. Verifică textul înainte și tratează `JsonException`. Învață C# de la zero, cu exerciții la fiecare lecție
Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
