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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Ai declarat în model un index unic (HasIndex(u => u.Email).IsUnique()), iar migrarea l-a creat în SQLite. Când inserezi sau actualizezi un rând cu o valoare care există deja, baza refuză operația cu codul 19 (SQLITE_CONSTRAINT) și numele coloanei: UNIQUE constraint failed: Utilizatori.Email. Pentru un index pe mai multe coloane, apar toate, separate prin virgulă.
EF Core primește eroarea la SaveChanges și o pune în InnerException a unui DbUpdateException. Fără tratare, clientul API-ului primește 500, deși problema e una de business: emailul e deja folosit. Răspunsul corect pentru el este 409 Conflict (sau 400 cu un mesaj clar).
Atenție: providerul InMemory nu verifică indexurile unice, deci testele pe InMemory pot trece, iar aplicația pe SQLite să pice.
De ce apare: cauzele frecvente
1Inserare fără verificare
db.Utilizatori.Add(u);
db.SaveChanges();
return Results.Created($"/utilizatori/{u.Id}", u);if (db.Utilizatori.Any(x => x.Email == u.Email))
return Results.Conflict($"Emailul {u.Email} este deja folosit.");
db.Utilizatori.Add(u);
db.SaveChanges();Verificarea transformă cazul obișnuit într-un 409 cu mesaj, fără să mai ajungi la eroarea bazei.
2Plasa de siguranță pentru cereri simultane
catch (DbUpdateException)
{
return Results.Problem(statusCode: 500);
}catch (DbUpdateException ex) when (ex.InnerException is SqliteException { SqliteErrorCode: 19 })
{
return Results.Conflict("Emailul este deja folosit.");
}Două cereri pot trece simultan de Any. Prinzi doar eroarea de constrângere și o traduci tot în 409.
3Comparație care depinde de majuscule
if (db.Utilizatori.Any(x => x.Email == u.Email)) ...var email = u.Email.Trim().ToLowerInvariant();
if (db.Utilizatori.Any(x => x.Email == email)) ...Dacă salvezi emailurile normalizate, compară tot cu forma normalizată, altfel „Ana@x.ro” și „ana@x.ro” trec de verificare.
Repară eroarea, direct în pagină
Al doilea POST /utilizatori cu același email răspunde 500 cu SQLite Error 19: 'UNIQUE constraint failed: Utilizatori.Email'. Verifică emailul înainte de salvare și răspunde 409 Conflict cu mesajul Emailul <email> este deja folosit..
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseSqlite("Data Source=app.db"));
var app = builder.Build();
app.MapPost("/utilizatori", (Utilizator u, AppDb db) =>
{
try
{
db.Utilizatori.Add(u);
db.SaveChanges();
return Results.Created($"/utilizatori/{u.Id}", u);
}
catch (DbUpdateException ex)
{
return Results.Problem(ex.InnerException?.Message ?? ex.Message, statusCode: 500);
}
});
app.Run();
public class Utilizator
{
public int Id { get; set; }
public string Email { get; set; } = "";
public string? Nume { get; set; }
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Utilizator> Utilizatori => Set<Utilizator>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Utilizator>().HasIndex(u => u.Email).IsUnique();
}
}POST /utilizatori → 201 Created
Location: /utilizatori/1
{"id":1,"email":"ana@exemplu.ro","nume":"Ana"}
POST /utilizatori → 409 Conflict
"Emailul ana@exemplu.ro este deja folosit."Indiciu
Înainte de Add, întreabă baza cu Any dacă există deja un utilizator cu acest email.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseSqlite("Data Source=app.db"));
var app = builder.Build();
app.MapPost("/utilizatori", (Utilizator u, AppDb db) =>
{
if (db.Utilizatori.Any(x => x.Email == u.Email))
return Results.Conflict($"Emailul {u.Email} este deja folosit.");
db.Utilizatori.Add(u);
db.SaveChanges();
return Results.Created($"/utilizatori/{u.Id}", u);
});
app.Run();
public class Utilizator
{
public int Id { get; set; }
public string Email { get; set; } = "";
public string? Nume { get; set; }
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Utilizator> Utilizatori => Set<Utilizator>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Utilizator>().HasIndex(u => u.Email).IsUnique();
}
}De ce merge
Indexul unic din model își face treaba: SQLite refuză al doilea rând cu același email. Problema era că refuzul ajungea la client ca 500. Verificarea cu Any detectează duplicatul înainte de inserare și răspunde 409 cu un mesaj pe care clientul îl poate afișa. Indexul rămâne în model ca garanție în cazul a două cereri simultane.
Alte forme ale mesajului
SQLite Error 19: 'UNIQUE constraint failed: Produse.Cod'.SQLite Error 19: 'UNIQUE constraint failed: Inscrieri.ElevId, Inscrieri.CursId'.
Cum o eviți pe viitor
- Pune index unic în bază pentru orice regulă de unicitate (email, cod produs, număr de factură).
- Verifică existența înainte de inserare și răspunde 409 Conflict.
- Prinde
DbUpdateExceptionpentru cazul concurent și tradu-l tot în 409. - Testează pe SQLite sau pe baza reală, nu doar pe InMemory, care ignoră indexurile unice.
Întrebări frecvente
Verificarea cu Any nu e suficientă dacă două cereri vin simultan?
Corect: între Any și SaveChanges, altă cerere poate insera același email. Indexul unic rămâne apărarea finală, deci prinde și DbUpdateException (verificând codul erorii bazei) și răspunde tot 409.
De ce testele mele cu UseInMemoryDatabase nu prind problema?
Providerul InMemory nu aplică indexurile unice (nici cheile străine). E bun pentru logică simplă, dar pentru constrângeri folosește SQLite în memorie sau un container cu baza reală.
Erori înrudite
Microsoft.Data.SqlClient.SqlException (0x80131904): Cannot insert duplicate key row in object 'dbo.Utilizatori' with unique index 'IX_Utilizatori_Email'. The duplicate key value is (ana@exemplu.ro). SQL Server refuză un rând care repetă valoarea dintr-un index unic (IX_Utilizatori_Email). Verifică existența înainte de inserare și răspunde 409, iar pentru cereri simultane prinde SqlException cu Number 2601 sau 2627. Npgsql.PostgresException (0x80004005): 23505: duplicate key value violates unique constraint "IX_Utilizatori_Email" PostgreSQL refuză un rând care repetă valoarea dintr-un index unic. 23505 e codul SQLSTATE pentru unique_violation. Verifică existența înainte de inserare și răspunde 409, iar pentru cereri simultane prinde PostgresException cu SqlState 23505. 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ă. Î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.
