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.
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 !
var client = new Client { Email = date.Email! };
db.Clienti.Add(client);
db.SaveChanges();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
public class Client
{
public int Id { get; set; }
public string Telefon { get; set; } = null!;
}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
client.Email = dto.Email; // null din cerere
db.SaveChanges();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ă 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.
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>();
}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.
Reparația
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) =>
{
if (string.IsNullOrWhiteSpace(date.Email))
return Results.ValidationProblem(new Dictionary<string, string[]> { ["email"] = ["Emailul este obligatoriu."] });
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>();
}De ce merge
Email e string non-nullable, deci obligatoriu pentru EF. DTO-ul îl declara string?, iar date.Email! ascundea avertismentul, așa că null ajungea în entitate și SaveChanges arunca excepția (500). Validarea de la început oprește cererea incompletă cu un 400 explicit, în format ProblemDetails, iar a doua cerere, completă, ajunge la bază și primește 201 cu Location.
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 laSaveChanges. - 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ă
DbUpdateExceptiondoar 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
Microsoft.Data.Sqlite.SqliteException (0x80004005): SQLite Error 19: 'NOT NULL constraint failed: Produse.Categorie'. Încerci să salvezi NULL într-o coloană NOT NULL din SQLite (aici Produse.Categorie). Dă proprietății o valoare (sau o valoare implicită) înainte de SaveChanges, validează cererea, ori fă coloana opțională cu string? și o migrare nouă. Microsoft.EntityFrameworkCore.DbUpdateException: An error occurred while saving the entity changes. See the inner exception for details. Baza de date a refuzat SaveChanges, iar EF a învelit eroarea reală în InnerException. Citește ex.InnerException.Message (sau logul complet): acolo e cauza exactă, de obicei o constrângere încălcată (UNIQUE, NOT NULL, FOREIGN KEY) sau o coloană prea lungă. Î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.
