...
Eroare ASP.NET Core · Entity Framework Core

System.NullReferenceException: Object reference not set to an instance of an object. (navigare EF Core neîncărcată, fără Include)

Pe scurt

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ânci ThenInclude;
  • proiecție: Select(p => new { p.Nume, Categorie = p.Categorie.Nume }) chiar în interogare, înainte de ToList; EF face JOIN-ul și nu ai nevoie de Include;
  • 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

Greșit
C#
var produse = db.Produse.ToList();
var texte = produse.Select(p => p.Categorie!.Nume);
Corect
C#
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

Greșit
C#
db.Produse.ToList().Select(p => new { p.Nume, Cat = p.Categorie!.Nume });
Corect
C#
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

Greșit
C#
var numar = categorie.Produse.Count; // 0, deși are produse
Corect
C#
var 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ă tu

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

Codul care dă eroarea
C#
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>();
}
După reparație, programul afișează
GET /produse → 200 OK
["Laptop (IT)","Mouse (IT)"]
Indiciu

EF nu încarcă singur entitățile legate: trebuie să i le ceri în interogare.

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 (Include sau Select).
  • 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 Include pe colecții mari (produs cartezian); folosește AsSplitQuery la 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).

← Toate erorile ASP.NET Core

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ță 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.