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

Microsoft.Data.Sqlite.SqliteException (0x80004005): SQLite Error 19: 'NOT NULL constraint failed: Produse.Categorie'.

Pe scurt

Î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

Greșit
C#
var produs = new Produs { Categorie = date.Categorie! };
db.Produse.Add(produs);
db.SaveChanges();
Corect
C#
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ă

Greșit
C#
public string Categorie { get; set; } = null!;
Corect
C#
public string? Categorie { get; set; }
// dotnet ef migrations add CategorieOptionala

Cu string?, migrarea generează coloana NULL-abilă. Fără migrare nouă, schema bazei rămâne cea veche.

3Coloană nouă fără valoare implicită

Greșit
C#
m.Entity<Produs>().Property(p => p.Categorie).IsRequired();
Corect
C#
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ă tu

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.

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", (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>();
}
După reparație, programul afișează
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.

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

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