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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Acesta e mesajul „plic” al EF Core: SaveChanges a trimis comenzile INSERT/UPDATE/DELETE, iar baza de date a răspuns cu o eroare. EF nu o interpretează, ci o pune în proprietatea InnerException a unui DbUpdateException și îți spune exact asta: „See the inner exception for details”.
Cauza adevărată e mereu un nivel mai jos. Cele mai frecvente:
- index unic sau cheie primară duplicată (
UNIQUE constraint failed,Cannot insert duplicate key,23505); NULLîntr-o coloană obligatorie;- cheie străină către un rând care nu există (
FOREIGN KEY constraint failed,23503); - text mai lung decât coloana (
String or binary data would be truncated); - tabel sau coloană lipsă pentru că nu ai aplicat migrările.
Dacă excepția ajunge netratată, clientul primește 500, iar în pagina de dezvoltator sau în log vezi doar acest mesaj general. De aceea logarea corectă (LogError(ex, ...), care include toată lanțul de excepții) e primul pas.
De ce apare: cauzele frecvente
1Excepția nu e tratată
db.Produse.Add(p);
db.SaveChanges();try
{
db.Produse.Add(p);
db.SaveChanges();
}
catch (DbUpdateException ex)
{
log.LogWarning("Salvare respinsă: {Motiv}", ex.InnerException?.Message);
return Results.Conflict("Produsul există deja.");
}Pentru erorile previzibile (duplicate), traduci excepția într-un răspuns potrivit și păstrezi motivul în log.
2Logarea pierde cauza
catch (Exception ex)
{
log.LogError(ex.Message);
}catch (Exception ex)
{
log.LogError(ex, "Eroare la salvarea comenzii {Id}", comanda.Id);
}ex.Message conține doar plicul. Cu excepția ca prim argument, loggerul scrie și InnerException, cu stiva.
3Migrările nu sunt aplicate
// modelul are coloana Cod, baza nu
db.SaveChanges();// dotnet ef migrations add AdaugaCod
// dotnet ef database update
db.SaveChanges();Dacă schema nu corespunde modelului, baza răspunde „no such column” sau „Invalid column name”, tot în InnerException.
Repară eroarea, direct în pagină
Al doilea POST /produse cu același cod răspunde 500 cu An error occurred while saving the entity changes. See the inner exception for details.. Prinde DbUpdateException, loghează motivul real ca avertisment și răspunde 409 Conflict cu Produsul cu codul <cod> există deja..
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseSqlite("Data Source=magazin.db"));
var app = builder.Build();
app.MapPost("/produse", (Produs p, AppDb db) =>
{
db.Produse.Add(p);
db.SaveChanges();
return Results.Created($"/produse/{p.Id}", p);
});
app.Run();
public class Produs
{
public int Id { get; set; }
public string Cod { get; set; } = "";
public string Nume { get; set; } = "";
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Produs> Produse => Set<Produs>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Produs>().HasIndex(p => p.Cod).IsUnique();
}
}POST /produse → 201 Created
Location: /produse/1
{"id":1,"cod":"LP-01","nume":"Laptop"}
warn: Program[0]
Salvare respinsă: SQLite Error 19: 'UNIQUE constraint failed: Produse.Cod'.
POST /produse → 409 Conflict
"Produsul cu codul LP-01 există deja."Indiciu
Pune Add și SaveChanges într-un try și prinde DbUpdateException; motivul real e în InnerException.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseSqlite("Data Source=magazin.db"));
var app = builder.Build();
app.MapPost("/produse", (Produs p, AppDb db, ILogger<Program> log) =>
{
try
{
db.Produse.Add(p);
db.SaveChanges();
return Results.Created($"/produse/{p.Id}", p);
}
catch (DbUpdateException ex)
{
log.LogWarning("Salvare respinsă: {Motiv}", ex.InnerException?.Message);
return Results.Conflict($"Produsul cu codul {p.Cod} există deja.");
}
});
app.Run();
public class Produs
{
public int Id { get; set; }
public string Cod { get; set; } = "";
public string Nume { get; set; } = "";
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Produs> Produse => Set<Produs>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Produs>().HasIndex(p => p.Cod).IsUnique();
}
}De ce merge
Indexul unic pe Cod făcea SQLite să refuze al doilea produs, iar EF arunca plicul DbUpdateException, care ajungea ca 500. Acum excepția e prinsă: logul primește mesajul real din InnerException (în laborator apare pe consolă ca warn), iar clientul primește 409 cu un mesaj controlat, fără detalii interne ale bazei.
Alte forme ale mesajului
Microsoft.EntityFrameworkCore.DbUpdateException: An error occurred while updating the entries. See the inner exception for details.
Cum o eviți pe viitor
- Loghează excepțiile cu
LogError(ex, ...), niciodată doarex.Message. - Tratează explicit cazurile previzibile (duplicate, chei străine) și transformă-le în 409 sau 400.
- Validează datele înainte de salvare, ca baza să fie ultima plasă de siguranță.
- Aplică migrările în toate mediile înainte de deploy.
Întrebări frecvente
Care e diferența față de „An error occurred while updating the entries”?
Este același tip de eroare: versiunile mai vechi de EF Core foloseau „updating the entries”, cele noi „saving the entity changes”. În ambele cazuri cauza e în InnerException.
Cum văd SQL-ul care a eșuat?
Activează logarea EF (Microsoft.EntityFrameworkCore.Database.Command pe Information) și, doar în dezvoltare, EnableSensitiveDataLogging() ca să vezi și valorile parametrilor.
Erori înrudite
Microsoft.Data.Sqlite.SqliteException (0x80004005): SQLite Error 19: 'UNIQUE constraint failed: Utilizatori.Email'. Încerci să inserezi o valoare care există deja într-o coloană cu index unic (aici Utilizatori.Email). Verifică înainte dacă valoarea există și răspunde 409 Conflict, iar ca plasă de siguranță prinde DbUpdateException pentru inserările simultane. 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: 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. Î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.
