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

Npgsql.PostgresException (0x80004005): 23505: duplicate key value violates unique constraint "IX_Utilizatori_Email"

Pe scurt

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

Greșit
C#
db.Utilizatori.Add(u);
db.SaveChanges();
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();

Duplicatul obișnuit devine 409 înainte să ajungă la bază.

2Tratarea după SqlState

Greșit
C#
catch (DbUpdateException ex)
{
    return Results.Problem(ex.InnerException!.Message);
}
Corect
C#
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ă

Greșit
C#
INSERT INTO "Utilizatori" ("Id", "Email") VALUES (1, 'a@x.ro'), (2, 'b@x.ro');
-- următorul INSERT fără Id primește 1
Corect
C#
SELECT 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ă tu

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

Codul care dă eroarea
C#
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();
    }
}
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

Întreabă baza dacă emailul există, înainte de a insera.

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 PostgresException cu SqlState == PostgresErrorCodes.UniqueViolation pentru 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

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