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

Microsoft.EntityFrameworkCore.DbUpdateException: An error occurred while saving the entity changes. See the inner exception for details.

Pe scurt

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ă

Greșit
C#
db.Produse.Add(p);
db.SaveChanges();
Corect
C#
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

Greșit
C#
catch (Exception ex)
{
    log.LogError(ex.Message);
}
Corect
C#
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

Greșit
C#
// modelul are coloana Cod, baza nu
db.SaveChanges();
Corect
C#
// 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ă tu

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

Codul care dă eroarea
C#
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();
    }
}
După reparație, programul afișează
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.

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ă doar ex.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

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