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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la PostgreSQL, prin driverul Npgsql. 23505 este codul standard SQLSTATE pentru unique_violation, iar între ghilimele e numele constrângerii sau al indexului încălcat. IX_Utilizatori_Email e numele dat de EF Core indexului unic declarat cu HasIndex(u => u.Email).IsUnique(); pentru cheia primară ar fi PK_Utilizatori.
În detaliile excepției (Detail) PostgreSQL adaugă și valoarea: Key ("Email")=(ana@exemplu.ro) already exists. (doar dacă ai activat Include Error Detail=true în connection string).
EF Core aruncă un DbUpdateException la SaveChanges, cu PostgresException în InnerException. O altă cauză frecventă pe PostgreSQL: ai inserat date cu id-uri explicite (seed, import), iar secvența coloanei identity a rămas în urmă; următorul INSERT primește un id deja folosit și dă tot 23505, pe PK_....
De ce apare: cauzele frecvente
1Inserare fără verificare
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();Duplicatul obișnuit devine 409 înainte să ajungă la bază.
2Tratarea după SqlState
catch (DbUpdateException ex)
{
return Results.Problem(ex.InnerException!.Message);
}catch (DbUpdateException ex) when (ex.InnerException is PostgresException { SqlState: PostgresErrorCodes.UniqueViolation })
{
return Results.Conflict("Emailul este deja folosit.");
}PostgresErrorCodes.UniqueViolation este constanta pentru 23505; filtrul lasă celelalte erori să rămână 500.
3Secvența identity rămasă în urmă
INSERT INTO "Utilizatori" ("Id", "Email") VALUES (1, 'a@x.ro'), (2, 'b@x.ro');
-- următorul INSERT fără Id primește 1SELECT setval(pg_get_serial_sequence('"Utilizatori"', 'Id'),
(SELECT MAX("Id") FROM "Utilizatori"));După inserări cu id explicit, actualizează secvența, ca id-urile generate să continue de la cel mai mare existent.
Repară eroarea, direct în pagină
API-ul pe PostgreSQL răspunde 500 cu 23505: duplicate key value violates unique constraint "IX_Utilizatori_Email" la a doua înregistrare cu același email. 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.UseNpgsql("Host=localhost;Database=magazin;Username=app;Password=parola"));
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
Întreabă baza dacă emailul există, înainte de a insera.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseNpgsql("Host=localhost;Database=magazin;Username=app;Password=parola"));
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
PostgreSQL aplică indexul unic și refuză duplicatul cu SQLSTATE 23505. Endpoint-ul îl trimitea clientului ca 500 cu textul intern al bazei. Cu verificarea Any, al doilea utilizator cu același email primește 409 și un mesaj clar, iar primul e creat cu 201. Indexul rămâne în model pentru cazul a două cereri simultane.
Alte forme ale mesajului
23505: duplicate key value violates unique constraint "PK_Utilizatori"Npgsql.PostgresException: 23505: duplicate key value violates unique constraint "IX_Produse_Cod"
Cum o eviți pe viitor
- Verifică unicitatea în cod și răspunde 409; păstrează indexul unic ca garanție.
- Prinde
PostgresExceptioncuSqlState == PostgresErrorCodes.UniqueViolationpentru cereri concurente. - După importuri cu id-uri explicite, resincronizează secvențele.
- Pentru „inserează sau ignoră”, PostgreSQL are
INSERT ... ON CONFLICT DO NOTHING(prin SQL brut sau biblioteci dedicate).
Î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.
Ce este SQLSTATE?
Un cod de cinci caractere standardizat în SQL. Clasa 23 înseamnă încălcarea unei constrângeri de integritate: 23505 unicitate, 23503 cheie străină, 23502 valoare NULL în coloană NOT NULL.
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. 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.
