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

Microsoft.Data.Sqlite.SqliteException (0x80004005): SQLite Error 19: 'UNIQUE constraint failed: Utilizatori.Email'.

Pe scurt

Î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

Greșit
C#
db.Utilizatori.Add(u);
db.SaveChanges();
return Results.Created($"/utilizatori/{u.Id}", u);
Corect
C#
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

Greșit
C#
catch (DbUpdateException)
{
    return Results.Problem(statusCode: 500);
}
Corect
C#
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

Greșit
C#
if (db.Utilizatori.Any(x => x.Email == u.Email)) ...
Corect
C#
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ă tu

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

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

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 DbUpdateException pentru 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

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