System.NullReferenceException: Object reference not set to an instance of an object. (navigare EF Core neîncărcată, fără Include)
EF Core nu încarcă automat entitățile legate: după ToList, p.Categorie e null dacă n-ai cerut-o. Adaugă Include(p => p.Categorie) în interogare sau proiectează direct în Select (p.Categorie.Nume), înainte de ToList.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Proprietățile de navigare (Produs.Categorie, Categorie.Produse) nu sunt încărcate implicit. Când citești produsele, EF aduce doar coloanele tabelului Produse; CategorieId are valoare, dar obiectul Categorie rămâne null, iar colecțiile rămân goale. Dacă după aceea accesezi p.Categorie.Nume în memorie, primești NullReferenceException.
Este încărcare „lazy” doar dacă o activezi explicit (pachetul Proxies), iar în API-uri e de obicei nedorită. Ai trei variante de încărcare:
- eager:
Include(p => p.Categorie), iar pentru niveluri mai adânciThenInclude; - proiecție:
Select(p => new { p.Nume, Categorie = p.Categorie.Nume })chiar în interogare, înainte deToList; EF face JOIN-ul și nu ai nevoie deInclude; - explicită:
db.Entry(p).Reference(x => x.Categorie).Load().
Indiciu de depanare: dacă eroarea apare doar după ToList() și numai pe navigări, lipsește Include. Operatorul ! (p.Categorie!.Nume) doar ascunde avertismentul compilatorului, nu încarcă nimic.
De ce apare: cauzele frecvente
1Navigare folosită după ToList
var produse = db.Produse.ToList();
var texte = produse.Select(p => p.Categorie!.Nume);var produse = db.Produse.Include(p => p.Categorie).ToList();
var texte = produse.Select(p => p.Categorie!.Nume);Include adaugă JOIN-ul în SQL și completează p.Categorie pentru fiecare produs.
2Proiecție înainte de materializare
db.Produse.ToList().Select(p => new { p.Nume, Cat = p.Categorie!.Nume });db.Produse.Select(p => new { p.Nume, Cat = p.Categorie!.Nume }).ToList();În interogare, Select e tradus în SQL cu JOIN; în memorie, după ToList, navigarea e deja null.
3Colecție goală, nu null
var numar = categorie.Produse.Count; // 0, deși are produsevar categorie = db.Categorii.Include(c => c.Produse).First(c => c.Id == id);
var numar = categorie.Produse.Count;Colecțiile inițializate cu [] nu dau excepție, dar dau rezultate greșite fără Include.
Repară eroarea, direct în pagină
GET /produse răspunde 500 cu NullReferenceException, pentru că p.Categorie e null. Repară interogarea ca fiecare produs să fie afișat ca Nume (Categorie), de exemplu Laptop (IT).
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseInMemoryDatabase("magazin"));
var app = builder.Build();
using (var scope = app.Services.CreateScope())
{
var db = scope.ServiceProvider.GetRequiredService<AppDb>();
var it = new Categorie { Nume = "IT" };
db.Produse.AddRange(new Produs { Nume = "Laptop", Categorie = it }, new Produs { Nume = "Mouse", Categorie = it });
db.SaveChanges();
}
app.MapGet("/produse", (AppDb db) =>
db.Produse.OrderBy(p => p.Id).ToList()
.Select(p => $"{p.Nume} ({p.Categorie!.Nume})"));
app.Run();
public class Categorie
{
public int Id { get; set; }
public string Nume { get; set; } = "";
}
public class Produs
{
public int Id { get; set; }
public string Nume { get; set; } = "";
public int CategorieId { get; set; }
public Categorie? Categorie { get; set; }
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Categorie> Categorii => Set<Categorie>();
public DbSet<Produs> Produse => Set<Produs>();
}GET /produse → 200 OK ["Laptop (IT)","Mouse (IT)"]
Indiciu
EF nu încarcă singur entitățile legate: trebuie să i le ceri în interogare.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseInMemoryDatabase("magazin"));
var app = builder.Build();
using (var scope = app.Services.CreateScope())
{
var db = scope.ServiceProvider.GetRequiredService<AppDb>();
var it = new Categorie { Nume = "IT" };
db.Produse.AddRange(new Produs { Nume = "Laptop", Categorie = it }, new Produs { Nume = "Mouse", Categorie = it });
db.SaveChanges();
}
app.MapGet("/produse", (AppDb db) =>
db.Produse.Include(p => p.Categorie).OrderBy(p => p.Id).ToList()
.Select(p => $"{p.Nume} ({p.Categorie!.Nume})"));
app.Run();
public class Categorie
{
public int Id { get; set; }
public string Nume { get; set; } = "";
}
public class Produs
{
public int Id { get; set; }
public string Nume { get; set; } = "";
public int CategorieId { get; set; }
public Categorie? Categorie { get; set; }
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Categorie> Categorii => Set<Categorie>();
public DbSet<Produs> Produse => Set<Produs>();
}De ce merge
Interogarea aducea doar produsele, deci p.Categorie rămânea null, iar p.Categorie!.Nume arunca NullReferenceException (operatorul ! doar tăcea avertismentul). Include(p => p.Categorie) îi cere lui EF să aducă și categoria fiecărui produs, iar formatarea în memorie funcționează. O alternativă la fel de bună este proiecția în Select înainte de ToList.
Alte forme ale mesajului
System.NullReferenceException: Object reference not set to an instance of an object.
Cum o eviți pe viitor
- Decide pentru fiecare interogare ce date îți trebuie și încarcă-le explicit (
IncludesauSelect). - Preferă proiecțiile în DTO-uri pentru API-uri: aduci doar coloanele necesare.
- Nu folosi
!pe navigări ca să scapi de avertisment; tratează avertismentul ca semn că lipsește încărcarea. - Ai grijă la
Includepe colecții mari (produs cartezian); foloseșteAsSplitQueryla nevoie.
Întrebări frecvente
De ce uneori navigarea e completată chiar fără Include?
Dacă entitatea legată e deja urmărită de același context (încărcată mai devreme), EF leagă automat referințele („relationship fix-up”). Comportamentul depinde de ce s-a încărcat înainte, de aceea nu te baza pe el.
Ar trebui să activez lazy loading?
Rar într-un API: fiecare acces la o navigare devine o interogare separată (problema N+1), iar serializarea JSON poate declanșa zeci de interogări ascunse. Include sau proiecțiile sunt mai previzibile.
Erori înrudite
System.InvalidOperationException: Sequence contains no elements First, Single, Last, Min, Max sau Average au rulat pe o interogare fără niciun rezultat. Pentru căutări care pot să nu găsească nimic folosește FirstOrDefault (sau Find) și răspunde 404 când rezultatul e null. System.InvalidOperationException: The association between entity types 'Categorie' and 'Produs' has been severed, but the relationship is either marked as required or is implicitly required because the foreign key is not nullable. If the dependent/child entity should be deleted when a required relationship is severed, configure the relationship to use cascade deletes. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the key values. Ștergi un părinte (Categorie) care are copii încărcați (Produse), relația e obligatorie (cheie străină non-nullable) și nu are cascadă. Decide regula: interzici ștergerea (409), muți copiii, ștergi copiii (OnDelete Cascade) sau faci cheia străină nullable. error CS1061: 'DbSet<Produs>' does not contain a definition for 'ToListAsync' and no accessible extension method 'ToListAsync' accepting a first argument of type 'DbSet<Produs>' could be found (are you missing a using directive or an assembly reference?) Metodele asincrone și Include ale EF Core sunt metode de extensie din namespace-ul Microsoft.EntityFrameworkCore. Adaugă using Microsoft.EntityFrameworkCore; sus în fișier (și pachetul EF Core în proiect, dacă lipsește). Î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.
