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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la SQL Server și are trei informații: tabelul (dbo.Utilizatori), indexul unic încălcat (IX_Utilizatori_Email, numele generat de EF pentru HasIndex(u => u.Email).IsUnique()) și valoarea duplicată, în paranteză. Codul erorii este 2601 pentru un index unic și 2627 pentru o cheie primară sau o constrângere UNIQUE („Violation of PRIMARY KEY constraint...”).
EF Core îl primește la SaveChanges și îl pune în InnerException a unui DbUpdateException. Netratat, devine 500. Pentru clientul API-ului, situația e o eroare de business: resursa există deja, deci răspunsul potrivit este 409 Conflict.
Aceeași eroare apare când rescrii manual o cheie primară (de exemplu trimiți Id în corpul unui POST și el există deja), sau când seed-ul inserează de două ori aceleași date.
De ce apare: cauzele frecvente
1Inserare fără verificarea unicității
db.Utilizatori.Add(u);
db.SaveChanges();if (db.Utilizatori.Any(x => x.Email == u.Email))
return Results.Conflict($"Emailul {u.Email} este deja folosit.");
db.Utilizatori.Add(u);
db.SaveChanges();Cazul frecvent (utilizatorul se înregistrează din nou) primește un 409 clar, fără excepție.
2Tratarea erorii bazei după cod
catch (DbUpdateException ex)
{
return Results.Problem(ex.Message);
}catch (DbUpdateException ex) when (ex.InnerException is SqlException { Number: 2601 or 2627 })
{
return Results.Conflict("Emailul este deja folosit.");
}Filtrul when prinde doar încălcările de unicitate; alte erori rămân 500 și ajung în loguri.
3Clientul trimite cheia primară la creare
app.MapPost("/utilizatori", (Utilizator u, AppDb db) => { db.Add(u); db.SaveChanges(); });app.MapPost("/utilizatori", (UtilizatorNou d, AppDb db) =>
{
var u = new Utilizator { Email = d.Email };
db.Add(u);
db.SaveChanges();
});Un DTO fără Id lasă baza să genereze cheia, deci clientul nu poate ciocni cheile existente.
Repară eroarea, direct în pagină
API-ul pe SQL Server răspunde 500 cu Cannot insert duplicate key row in object 'dbo.Utilizatori' with unique index 'IX_Utilizatori_Email' când același email se înregistrează a doua oară. Răspunde în schimb 409 Conflict cu mesajul Emailul <email> este deja folosit..
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseSqlServer("Server=localhost;Database=Magazin;Trusted_Connection=True"));
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
Verifică cu Any dacă emailul există înainte de Add.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseSqlServer("Server=localhost;Database=Magazin;Trusted_Connection=True"));
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
SQL Server aplică indexul unic IX_Utilizatori_Email și refuză duplicatul cu eroarea 2601. Endpoint-ul trimitea mesajul bazei ca 500, ceea ce e și greșit semantic, și expune detalii interne. Verificarea cu Any prinde duplicatul înainte de inserare și răspunde cu 409 și un mesaj controlat. Primul utilizator e creat normal, cu 201.
Alte forme ale mesajului
Microsoft.Data.SqlClient.SqlException (0x80131904): Violation of PRIMARY KEY constraint 'PK_Utilizatori'. Cannot insert duplicate key in object 'dbo.Utilizatori'. The duplicate key value is (1).Violation of UNIQUE KEY constraint 'UQ_Produse_Cod'. Cannot insert duplicate key in object 'dbo.Produse'.
Cum o eviți pe viitor
- Definește indexuri unice pentru regulile de unicitate și verifică-le în cod înainte de inserare.
- Tradu erorile 2601/2627 în 409 Conflict, cu un filtru
whenpeSqlException.Number. - Nu accepta
Idde la client la creare: folosește DTO-uri. - Fă seed-ul idempotent (verifică dacă datele există).
Î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 mesajul conține valoarea duplicată? Nu e o problemă de securitate?
SQL Server o include pentru diagnostic. Nu trimite niciodată ex.Message direct clientului: logheaz-o și răspunde cu un mesaj controlat de tine.
Erori înrudite
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. 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.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ă. Î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.
