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

Microsoft.EntityFrameworkCore.DbUpdateException: Required properties '{'Email'}' are missing for the instance of entity type 'Client'. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the entity key value.

Pe scurt

La SaveChanges, o proprietate obligatorie a entității (string non-nullable sau [Required]) este null. Validează datele înainte de salvare și răspunde 400, sau fă proprietatea opțională (string?) dacă poate lipsi.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Cu nullable reference types activate, EF Core consideră obligatorie orice proprietate string declarată fără ?, la fel ca una marcată [Required] sau IsRequired(). În baza de date ea devine coloană NOT NULL.

Providerul InMemory verifică această regulă la SaveChanges și aruncă DbUpdateException cu lista proprietăților lipsă ('{'Email'}') și numele entității ('Client'). Pe SQL Server, PostgreSQL sau SQLite, baza însăși respinge rândul, iar mesajul apare în InnerException (de exemplu „NOT NULL constraint failed”).

Cum ajunge null acolo deși tipul e string? Compilatorul doar avertizează: date.Email! (operatorul „null-forgiving”), JSON-ul fără câmpul respectiv sau un DTO cu string? copiat în entitate pun null fără eroare de compilare. Problema reală e lipsa validării la intrare: clientul a trimis date incomplete și a primit 500 în loc de 400.

De ce apare: cauzele frecvente

1Copiere din DTO opțional cu !

Greșit
C#
var client = new Client { Email = date.Email! };
db.Clienti.Add(client);
db.SaveChanges();
Corect
C#
if (string.IsNullOrWhiteSpace(date.Email))
    return Results.ValidationProblem(new Dictionary<string, string[]>
        { ["email"] = ["Emailul este obligatoriu."] });
var client = new Client { Email = date.Email };

! doar ascunde avertismentul. Validarea transformă datele lipsă într-un 400 clar, înainte de bază.

2Câmpul chiar e opțional, dar e declarat obligatoriu

Greșit
C#
public class Client
{
    public int Id { get; set; }
    public string Telefon { get; set; } = null!;
}
Corect
C#
public class Client
{
    public int Id { get; set; }
    public string? Telefon { get; set; }
}

Dacă datele pot lipsi, declară proprietatea string?: coloana devine NULL-abilă și EF nu o mai cere.

3Câmp setat pe null la actualizare

Greșit
C#
client.Email = dto.Email; // null din cerere
db.SaveChanges();
Corect
C#
if (dto.Email is not null)
    client.Email = dto.Email;
db.SaveChanges();

La actualizări parțiale, nu suprascrie proprietăți obligatorii cu null doar pentru că lipsesc din cerere.

Repară tu

Repară eroarea, direct în pagină

Prima cerere POST /clienti, fără email, răspunde 500 cu Required properties '{'Email'}' are missing. Validează emailul înainte de salvare: fără email, răspunde 400 cu ValidationProblem pe cheia email; cu email, clientul se salvează și primește 201.

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();

app.MapPost("/clienti", (ClientNou date, AppDb db) =>
{
    var client = new Client { Nume = date.Nume, Email = date.Email! };
    db.Clienti.Add(client);
    db.SaveChanges();
    return Results.Created($"/clienti/{client.Id}", client);
});

app.Run();

public record ClientNou(string Nume, string? Email);

public class Client
{
    public int Id { get; set; }
    public string Nume { get; set; } = "";
    public string Email { get; set; } = "";
}

public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
    public DbSet<Client> Clienti => Set<Client>();
}
După reparație, programul afișează
POST /clienti → 400 Bad Request
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"email":["Emailul este obligatoriu."]}}
POST /clienti → 201 Created
Location: /clienti/1
{"id":1,"nume":"Ion","email":"ion@exemplu.ro"}
Indiciu

Verifică string.IsNullOrWhiteSpace(date.Email) înainte de Add.

Alte forme ale mesajului

  • Microsoft.EntityFrameworkCore.DbUpdateException: Required properties '{'Nume', 'Email'}' are missing for the instance of entity type 'Client' with the key value '{Id: 1}'.

Cum o eviți pe viitor

  • Validează intrarea (DataAnnotations, [ApiController], filtre) înainte să ajungi la SaveChanges.
  • Lasă avertismentele de nullable activate și nu le ascunde cu !.
  • Declară string? pentru ce e cu adevărat opțional, ca modelul să spună adevărul.
  • Tratează DbUpdateException doar ca plasă de siguranță, nu ca validare.

Întrebări frecvente

De ce nu primesc eroarea la compilare?

Nullable reference types produc doar avertismente, iar valorile vin la rulare (din JSON, din alte obiecte). EF vede null abia la salvare.

Pe SQL Server mesajul e altul. E aceeași problemă?

Da. Acolo baza respinge rândul („Cannot insert the value NULL into column 'Email'”), iar EF îl învelește în DbUpdateException cu mesajul real în InnerException.

Erori înrudite

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