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

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

Pe scurt

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

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();

Cazul frecvent (utilizatorul se înregistrează din nou) primește un 409 clar, fără excepție.

2Tratarea erorii bazei după cod

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

Greșit
C#
app.MapPost("/utilizatori", (Utilizator u, AppDb db) => { db.Add(u); db.SaveChanges(); });
Corect
C#
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ă tu

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

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

Verifică cu Any dacă emailul există înainte de Add.

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 when pe SqlException.Number.
  • Nu accepta Id de 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

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