System.ArgumentException: .NET number values such as positive and negative infinity cannot be written as valid JSON.
Răspunsul conține un double sau float cu valoarea NaN sau Infinity (de exemplu o medie calculată ca 0.0 / 0), iar JSON nu are reprezentare pentru ele, deci serializarea aruncă excepția și clientul primește 500. Tratează cazul fără date înainte de împărțire sau folosește decimal.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Standardul JSON permite doar numere finite. double și float au însă și valorile speciale NaN (rezultatul lui 0.0 / 0), PositiveInfinity (1.0 / 0) și NegativeInfinity. Când System.Text.Json întâlnește una dintre ele într-un răspuns, aruncă ArgumentException cu acest mesaj (și sugestia JsonNumberHandling.AllowNamedFloatingPointLiterals), iar endpoint-ul răspunde 500.
Cauza este aproape mereu o împărțire la zero cu double: media notelor pentru un produs fără recenzii, procentul dintr-un total zero, viteza într-un interval de timp zero. Cu int sau decimal, împărțirea la zero aruncă DivideByZeroException direct în cod; cu double, eroarea rămâne ascunsă până la serializare. Opțiunea AllowNamedFloatingPointLiterals scrie "NaN" ca text, dar clienții rareori știu ce să facă cu el.
De ce apare: cauzele frecvente
1Medie fără elemente
double medie = (double)recenzii.Sum(r => r.Nota) / recenzii.Count;
// 0 recenzii -> NaNdouble? medie = recenzii.Count == 0 ? null : recenzii.Average(r => r.Nota);Fără recenzii, media nu există: null în JSON spune exact asta.
2Procent dintr-un total zero
double procent = 100.0 * vandute / stocInitial;double procent = stocInitial == 0 ? 0 : 100.0 * vandute / stocInitial;Verifică numitorul înainte de împărțire.
Repară eroarea, direct în pagină
GET /produse/2/rating răspunde 500: .NET number values such as positive and negative infinity cannot be written as valid JSON., pentru că produsul 2 nu are recenzii. Repară calculul ca un produs fără recenzii să aibă medie: null, iar produsul 1 să aibă media notelor lui.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var recenzii = new List<Recenzie> { new(1, 5), new(1, 4) };
app.MapGet("/produse/{id:int}/rating", (int id) =>
{
var note = recenzii.Where(r => r.ProdusId == id).Select(r => r.Nota).ToList();
double medie = (double)note.Sum() / note.Count;
return new { produs = id, recenzii = note.Count, medie };
});
app.Run();
public record Recenzie(int ProdusId, int Nota);GET /produse/1/rating → 200 OK
{"produs":1,"recenzii":2,"medie":4.5}
GET /produse/2/rating → 200 OK
{"produs":2,"recenzii":0,"medie":null}Indiciu
Media nu există când nu sunt recenzii; tipul rezultatului trebuie să poată exprima asta.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var recenzii = new List<Recenzie> { new(1, 5), new(1, 4) };
app.MapGet("/produse/{id:int}/rating", (int id) =>
{
var note = recenzii.Where(r => r.ProdusId == id).Select(r => r.Nota).ToList();
double? medie = note.Count == 0 ? null : note.Average();
return new { produs = id, recenzii = note.Count, medie };
});
app.Run();
public record Recenzie(int ProdusId, int Nota);De ce merge
(double)suma / numar cu zero recenzii dădea 0.0 / 0, adică NaN, pe care JSON nu-l poate reprezenta. Cu double? medie, cazul fără recenzii devine null, iar altfel Average calculează media (4.5 pentru notele 5 și 4). Răspunsul are acum o valoare JSON validă în ambele cazuri.
Alte forme ale mesajului
System.ArgumentException: .NET number values such as positive and negative infinity cannot be written as valid JSON. To make it work when using 'JsonSerializer', consider specifying 'JsonNumberHandling.AllowNamedFloatingPointLiterals' (see https://learn.microsoft.com/dotnet/api/system.text.json.serialization.jsonnumberhandling).
Cum o eviți pe viitor
- Verifică numitorul la orice împărțire cu
doubleîn codul care produce răspunsuri. - Folosește
double?saudecimal?pentru valori care pot lipsi (media fără date). - Pentru bani și procente afișate, preferă
decimal: împărțirea la zero aruncă imediat, în locul potrivit.
Întrebări frecvente
De ce Average() pe o listă goală nu dă NaN?
Enumerable.Average pe o secvență goală aruncă InvalidOperationException: Sequence contains no elements. NaN apare doar când împarți tu suma la numărul zero, cu double.
Ar trebui să activez AllowNamedFloatingPointLiterals?
Doar dacă și clienții tăi înțeleg "NaN"/"Infinity" ca text. Pentru un API public e mai clar să trimiți null sau să eviți valorile speciale.
Erori înrudite
System.NotSupportedException: Serialization and deserialization of 'System.Type' instances is not supported. Path: $.Tip. Obiectul întors conține o proprietate de tip System.Type (de exemplu GetType() sau o excepție întreagă), pe care System.Text.Json refuză să o serializeze din motive de securitate. Întoarce doar textul de care ai nevoie: GetType().Name sau un DTO cu câmpuri simple. System.Text.Json.JsonException: A possible object cycle was detected. This can either be due to a cycle or if the object depth is larger than the maximum allowed depth of 64. Consider using ReferenceHandler.Preserve on JsonSerializerOptions to support cycles. Obiectul întors are o referință circulară (de exemplu Categorie.Produse și Produs.Categorie, ca la entitățile EF Core), iar serializarea JSON intră în buclă până la adâncimea maximă 64. Întoarce un DTO fără referința înapoi sau setează ReferenceHandler.IgnoreCycles. System.Text.Json.JsonException: The JSON value could not be converted to Stare. Path: $.stare | LineNumber: 0 | BytePositionInLine: 35. System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: cel mai des un enum trimis ca text ("Livrata") fără JsonStringEnumConverter, sau un text într-un număr. Adaugă convertorul pentru enum-uri sau corectează tipul. Path arată câmpul. Î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.
