System.Net.Http.HttpRequestException : Response status code does not indicate success: 401 (Unauthorized).
EnsureSuccessStatusCode() aruncă excepție pentru orice cod în afara 2xx. Cu 401, cererea nu avea un token valid: testul sau clientul HTTP nu s-a autentificat, a pus tokenul greșit, sau tokenul a expirat. Atașează Authorization: Bearer înainte de cerere.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
HttpResponseMessage.EnsureSuccessStatusCode() transformă orice răspuns în afara intervalului 200–299 într-o HttpRequestException, cu codul și descrierea lui în mesaj. Același lucru îl fac și scurtăturile GetStringAsync, GetFromJsonAsync și GetByteArrayAsync, care cheamă intern această metodă.
Când codul e 401 (Unauthorized), problema e de autentificare la client:
- clientul nu a trimis antetul
Authorization(în teste: clientul dinWebApplicationFactorye anonim); - tokenul a expirat sau a fost emis pentru alt mediu;
HttpCliente creat din nou la fiecare cerere și pierde antetul setat anterior;- antetul e pus pe alt client decât cel care face cererea.
Pentru 403 (Forbidden), utilizatorul e cunoscut, dar nu are rolul sau politica cerută. Pentru 404, ruta sau resursa nu există.
În teste, excepția ascunde corpul răspunsului; verifică întâi StatusCode cu Assert.Equal dacă vrei un mesaj mai clar.
De ce apare: cauzele frecvente
1Cerere protejată fără token
var r = await _client.GetAsync("/profil");
r.EnsureSuccessStatusCode();await Autentifica("ion");
var r = await _client.GetAsync("/profil");
r.EnsureSuccessStatusCode();Cu tokenul atașat, răspunsul e 200 și metoda nu mai aruncă.
2HttpClient nou la fiecare apel
using var http = new HttpClient(); // fără antetservices.AddHttpClient("api").AddHttpMessageHandler<HandlerToken>();Un handler care pune tokenul la fiecare cerere elimină uitarea antetului.
3Excepția ascunde detaliile
r.EnsureSuccessStatusCode();Assert.Equal(HttpStatusCode.OK, r.StatusCode);Assert.Equal arată direct codul primit, util la depanare.
Repară eroarea, direct în pagină
Testul Profil_contine_numele pică cu HttpRequestException : Response status code does not indicate success: 401 (Unauthorized).. Autentifică testul ca ion cu Autentifica, înainte de cererea către /profil, fără să elimini EnsureSuccessStatusCode().
using System.Security.Claims;
using System.Text;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.IdentityModel.Tokens;
using System.IdentityModel.Tokens.Jwt;
using System.Net;
using System.Net.Http.Headers;
using System.Net.Http.Json;
using Xunit;
using Microsoft.AspNetCore.Mvc.Testing;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(o =>
o.TokenValidationParameters = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "magazin",
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapPost("/login", (Login date) =>
{
var cheie = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti"));
var token = new JwtSecurityToken("academia", "magazin", [new Claim("sub", date.Utilizator)],
expires: DateTime.UtcNow.AddHours(1),
signingCredentials: new SigningCredentials(cheie, SecurityAlgorithms.HmacSha256));
return new { token = new JwtSecurityTokenHandler().WriteToken(token) };
});
app.MapGet("/profil", (ClaimsPrincipal user) =>
$"Profilul lui {user.FindFirstValue(ClaimTypes.NameIdentifier)}").RequireAuthorization();
app.Run();
public record Login(string Utilizator);
public record RaspunsLogin(string Token);
public partial class Program { }
public class TesteApi : IClassFixture<WebApplicationFactory<Program>>
{
private readonly HttpClient _client;
public TesteApi(WebApplicationFactory<Program> f) => _client = f.CreateClient();
private async Task Autentifica(string utilizator)
{
var r = await _client.PostAsJsonAsync("/login", new Login(utilizator));
var login = await r.Content.ReadFromJsonAsync<RaspunsLogin>();
_client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", login!.Token);
}
[Fact]
public async Task Profil_contine_numele()
{
var r = await _client.GetAsync("/profil");
r.EnsureSuccessStatusCode();
Assert.Equal("Profilul lui ion", await r.Content.ReadAsStringAsync());
}
}Rulez testele... Passed TesteApi.Profil_contine_numele Passed! - Failed: 0, Passed: 1, Skipped: 0, Total: 1
Indiciu
Adaugă await Autentifica("ion"); înainte de GetAsync.
Reparația
using System.Security.Claims;
using System.Text;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.IdentityModel.Tokens;
using System.IdentityModel.Tokens.Jwt;
using System.Net;
using System.Net.Http.Headers;
using System.Net.Http.Json;
using Xunit;
using Microsoft.AspNetCore.Mvc.Testing;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(o =>
o.TokenValidationParameters = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "magazin",
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapPost("/login", (Login date) =>
{
var cheie = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti"));
var token = new JwtSecurityToken("academia", "magazin", [new Claim("sub", date.Utilizator)],
expires: DateTime.UtcNow.AddHours(1),
signingCredentials: new SigningCredentials(cheie, SecurityAlgorithms.HmacSha256));
return new { token = new JwtSecurityTokenHandler().WriteToken(token) };
});
app.MapGet("/profil", (ClaimsPrincipal user) =>
$"Profilul lui {user.FindFirstValue(ClaimTypes.NameIdentifier)}").RequireAuthorization();
app.Run();
public record Login(string Utilizator);
public record RaspunsLogin(string Token);
public partial class Program { }
public class TesteApi : IClassFixture<WebApplicationFactory<Program>>
{
private readonly HttpClient _client;
public TesteApi(WebApplicationFactory<Program> f) => _client = f.CreateClient();
private async Task Autentifica(string utilizator)
{
var r = await _client.PostAsJsonAsync("/login", new Login(utilizator));
var login = await r.Content.ReadFromJsonAsync<RaspunsLogin>();
_client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", login!.Token);
}
[Fact]
public async Task Profil_contine_numele()
{
await Autentifica("ion");
var r = await _client.GetAsync("/profil");
r.EnsureSuccessStatusCode();
Assert.Equal("Profilul lui ion", await r.Content.ReadAsStringAsync());
}
}De ce merge
Clientul de test nu trimitea niciun token, deci /profil răspundea 401, iar EnsureSuccessStatusCode() transforma răspunsul în excepție. După Autentifica("ion"), clientul trimite Authorization: Bearer <token>, API-ul răspunde 200, iar corpul conține numele luat din claim-ul sub. Endpoint-ul nu a fost modificat.
Alte forme ale mesajului
System.Net.Http.HttpRequestException : Response status code does not indicate success: 403 (Forbidden).System.Net.Http.HttpRequestException: Response status code does not indicate success: 404 (Not Found).
Cum o eviți pe viitor
- În teste, autentifică clientul printr-o metodă comună înainte de cererile protejate.
- În aplicații, pune tokenul printr-un
DelegatingHandler, nu manual la fiecare apel. - Pentru depanare, loghează codul de stare și antetul
WWW-Authenticateînainte să arunci excepția. - Rulează testele de integrare la fiecare modificare, ca problema să fie prinsă înainte de producție, nu raportată de utilizatori.
Întrebări frecvente
De ce mesajul nu include motivul 401?
EnsureSuccessStatusCode folosește doar codul și descrierea standard. Motivul (invalid_token, expirat etc.) e în antetul WWW-Authenticate al răspunsului.
GetStringAsync aruncă la fel?
Da. GetStringAsync și GetFromJsonAsync cheamă EnsureSuccessStatusCode intern.
Erori înrudite
Assert.Equal() Failure: Values differ. Expected: OK. Actual: Unauthorized (test de integrare pe un endpoint protejat) Testul de integrare cheamă un endpoint cu RequireAuthorization() fără să trimită un token, deci API-ul răspunde corect 401. Testul trebuie să se autentifice întâi (login sau token de test) și să pună antetul Authorization: Bearer pe HttpClient. 401 Unauthorized cu antetul WWW-Authenticate: Bearer (fără token sau token trimis greșit) Endpoint-ul cere un utilizator autentificat, iar cererea nu are un token valid în antetul Authorization. Trimite antetul exact în forma Authorization: Bearer <token> (cu cuvântul Bearer și un spațiu), fără ghilimele în jurul tokenului. WWW-Authenticate: Bearer error="invalid_token", error_description="The token expired at '11/04/2026 10:15:00'" Tokenul JWT a expirat: ora din claim-ul exp e în trecut. Clientul trebuie să facă din nou login sau să folosească un refresh token. Dacă tokenurile expiră imediat după emitere, verifică durata la generare (unități, chei de configurare) și ceasul serverelor. Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
