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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine direct de la SQLite, nu de la EF. SQLite Error 19 este codul SQLITE_CONSTRAINT (o constrângere încălcată), iar textul spune care: NOT NULL constraint failed: Produse.Categorie, adică tabelul Produse, coloana Categorie.
EF Core îl primește la SaveChanges și îl învelește într-un DbUpdateException cu mesajul general „An error occurred while saving the entity changes. See the inner exception for details.” Mesajul de mai sus este în InnerException, deci în loguri trebuie să cauți mai jos în stivă.
Coloana e NOT NULL pentru că proprietatea era non-nullable (string, int) sau [Required] când ai creat migrarea. La salvare, valoarea a ajuns totuși null: din cererea JSON fără acel câmp, dintr-un DTO opțional copiat cu !, sau pentru că ai adăugat coloana în model fără valoare implicită și rândurile vechi nu au valoare.
De ce apare: cauzele frecvente
1Valoare opțională copiată într-o coloană obligatorie
var produs = new Produs { Categorie = date.Categorie! };
db.Produse.Add(produs);
db.SaveChanges();var produs = new Produs { Categorie = date.Categorie ?? "Diverse" };
db.Produse.Add(produs);
db.SaveChanges();Dacă există o valoare implicită de business, pune-o explicit cu ??. Altfel, validează și răspunde 400.
2Coloana ar trebui să fie opțională
public string Categorie { get; set; } = null!;public string? Categorie { get; set; }
// dotnet ef migrations add CategorieOptionalaCu string?, migrarea generează coloana NULL-abilă. Fără migrare nouă, schema bazei rămâne cea veche.
3Coloană nouă fără valoare implicită
m.Entity<Produs>().Property(p => p.Categorie).IsRequired();m.Entity<Produs>().Property(p => p.Categorie)
.IsRequired()
.HasDefaultValue("Diverse");HasDefaultValue pune DEFAULT în schemă, deci și rândurile inserate fără valoare primesc una.
Repară eroarea, direct în pagină
POST /produse fără categorie răspunde 500 cu SQLite Error 19: 'NOT NULL constraint failed: Produse.Categorie'. Repară endpoint-ul ca produsele fără categorie să primească automat categoria Diverse și să fie salvate cu 201.
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", (ProdusNou date, AppDb db) =>
{
try
{
var produs = new Produs { Nume = date.Nume, Categorie = date.Categorie! };
db.Produse.Add(produs);
db.SaveChanges();
return Results.Created($"/produse/{produs.Id}", produs);
}
catch (DbUpdateException ex)
{
return Results.Problem(ex.InnerException?.Message ?? ex.Message, statusCode: 500);
}
});
app.Run();
public record ProdusNou(string Nume, string? Categorie);
public class Produs
{
public int Id { get; set; }
public string Nume { get; set; } = "";
public string Categorie { get; set; } = "";
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Produs> Produse => Set<Produs>();
}POST /produse → 201 Created
Location: /produse/1
{"id":1,"nume":"Cablu USB","categorie":"Diverse"}
POST /produse → 201 Created
Location: /produse/2
{"id":2,"nume":"Laptop","categorie":"IT"}Indiciu
Operatorul ?? îți dă o valoare de rezervă când partea din stânga e null.
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", (ProdusNou date, AppDb db) =>
{
var produs = new Produs { Nume = date.Nume, Categorie = date.Categorie ?? "Diverse" };
db.Produse.Add(produs);
db.SaveChanges();
return Results.Created($"/produse/{produs.Id}", produs);
});
app.Run();
public record ProdusNou(string Nume, string? Categorie);
public class Produs
{
public int Id { get; set; }
public string Nume { get; set; } = "";
public string Categorie { get; set; } = "";
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Produs> Produse => Set<Produs>();
}De ce merge
Coloana Categorie e NOT NULL (proprietatea e string), iar date.Categorie! lăsa null să ajungă în entitate; SQLite respingea rândul cu eroarea 19. Cu date.Categorie ?? "Diverse", coloana primește mereu o valoare, iar blocul try/catch care transforma eroarea în 500 nu mai e necesar. Al doilea produs, care are categorie, o păstrează pe a lui.
Alte forme ale mesajului
Microsoft.EntityFrameworkCore.DbUpdateException: An error occurred while saving the entity changes. See the inner exception for details.SQLite Error 19: 'NOT NULL constraint failed: Clienti.Email'.
Cum o eviți pe viitor
- Validează cererile înainte de salvare și răspunde 400 la date lipsă.
- Ține modelul C# și schema sincronizate: după ce schimbi
?sau[Required], creează o migrare. - Pentru coloane noi obligatorii, dă o valoare implicită în migrare.
- În loguri, afișează și
InnerException, unde e mesajul real.
Întrebări frecvente
De ce văd doar „See the inner exception for details”?
EF învelește eroarea bazei. Mesajul exact este în ex.InnerException.Message; loggerul .NET afișează toată stiva dacă dai excepția ca prim argument la LogError(ex, ...).
Ce înseamnă 0x80004005?
Este codul HRESULT generic pentru eroare nespecificată din DbException. Informația utilă e în SqliteErrorCode (19) și în textul mesajului.
Erori înrudite
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. 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ă. 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. Î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.
