...
Eroare C# · Fișiere, HTTP, URI și JSON

System.Net.Http.HttpRequestException: Response status code does not indicate success: 404 (Not Found).

Pe scurt

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

Greșit
C#
var r = await client.GetAsync($"produse/{id}");
r.EnsureSuccessStatusCode();
Corect
C#
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

Greșit
C#
client.BaseAddress = new Uri("https://api.magazin.ro/v1");
var r = await client.GetAsync("/produse");
Corect
C#
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)

Greșit
C#
var json = await client.GetStringAsync("comenzi");
Corect
C#
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ă tu

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).

Codul care dă eroarea
C#
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);
    }
}
După reparație, programul afișează
{"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.

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 IsSuccessStatusCode când codurile de eroare sunt rezultate așteptate și EnsureSuccessStatusCode câ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

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.