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

System.ArgumentException: An item with the same key has already been added. Key: 1

Pe scurt

Inserezi un rând cu o cheie primară care există deja. În API-uri apare când clientul trimite id-ul în corpul unui POST și îl dai direct la Add. Primește un DTO fără Id și lasă baza să genereze cheia; pentru actualizări folosește PUT pe resursa existentă.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul vine de la un Dictionary intern: cheia 1 există deja în colecție, iar Add nu acceptă duplicate. Cu EF Core, îl vezi la SaveChanges pe providerul InMemory, care ține fiecare tabel ca dicționar după cheia primară (EF îl învelește într-un DbUpdateException). Pe o bază relațională, aceeași greșeală produce eroarea de cheie primară duplicată a bazei (Violation of PRIMARY KEY constraint, UNIQUE constraint failed: Carti.Id, 23505).

Cauza obișnuită într-un API: endpoint-ul de creare primește direct entitatea (Carte carte), iar clientul trimite și "id": 1, fie din greșeală, fie pentru că a copiat un obiect existent. EF respectă valoarea dată și încearcă să o insereze. Nu doar că dă eroare la duplicat, dar îi permite clientului să-și aleagă cheile, ceea ce rar e dorit.

În afara EF, același mesaj apare la dictionar.Add(cheie, valoare), la ToDictionary cu chei duplicate sau la antete adăugate de două ori.

De ce apare: cauzele frecvente

1Entitatea primită direct în POST

Greșit
C#
app.MapPost("/carti", (Carte carte, Biblioteca db) =>
{
    db.Carti.Add(carte);
    db.SaveChanges();
});
Corect
C#
app.MapPost("/carti", (CarteNoua date, Biblioteca db) =>
{
    var carte = new Carte { Titlu = date.Titlu, Autor = date.Autor };
    db.Carti.Add(carte);
    db.SaveChanges();
});

DTO-ul nu are Id, deci cheia e mereu generată de bază.

2Cheie setată manual din cod

Greșit
C#
db.Carti.Add(new Carte { Id = db.Carti.Count(), Titlu = t });
Corect
C#
db.Carti.Add(new Carte { Titlu = t });

Calcularea manuală a id-ului dă coliziuni (și curse între cereri). Lasă generarea în seama bazei.

3ToDictionary cu chei repetate

Greșit
C#
var dupaAutor = carti.ToDictionary(c => c.Autor);
Corect
C#
var dupaAutor = carti.GroupBy(c => c.Autor)
    .ToDictionary(g => g.Key, g => g.ToList());

Când cheia se poate repeta, grupează întâi.

Repară tu

Repară eroarea, direct în pagină

POST /carti cu "id": 1 în corp răspunde 500 cu An item with the same key has already been added. Key: 1, pentru că există deja cartea 1. Primește un DTO CarteNoua fără id, ca baza să genereze cheia, iar cartea să fie creată cu 201.

Codul care dă eroarea
C#
using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<Biblioteca>(o => o.UseInMemoryDatabase("biblioteca"));
var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var db = scope.ServiceProvider.GetRequiredService<Biblioteca>();
    db.Carti.Add(new Carte { Titlu = "Ion", Autor = "Liviu Rebreanu" });
    db.SaveChanges();
}

app.MapPost("/carti", (Carte carte, Biblioteca db) =>
{
    db.Carti.Add(carte);
    db.SaveChanges();
    return Results.Created($"/carti/{carte.Id}", carte);
});

app.Run();

public class Carte
{
    public int Id { get; set; }
    public string Titlu { get; set; } = "";
    public string Autor { get; set; } = "";
}

public class Biblioteca(DbContextOptions<Biblioteca> options) : DbContext(options)
{
    public DbSet<Carte> Carti => Set<Carte>();
}
După reparație, programul afișează
POST /carti → 201 Created
Location: /carti/2
{"id":2,"titlu":"Baltagul","autor":"Mihail Sadoveanu"}
Indiciu

Construiește entitatea Carte în handler, din câmpurile DTO-ului, fără Id.

Alte forme ale mesajului

  • Microsoft.EntityFrameworkCore.DbUpdateException: An item with the same key has already been added. Key: 1
  • System.ArgumentException: An item with the same key has already been added. Key: Ana

Cum o eviți pe viitor

  • Folosește DTO-uri fără Id la creare; nu lega entitățile direct de corpul cererii.
  • Lasă baza să genereze cheile (int/long identity, Guid).
  • Pentru „creează sau actualizează”, verifică existența și decide explicit.
  • În cod obișnuit, folosește TryAdd sau indexatorul când cheia se poate repeta.

Întrebări frecvente

De ce primul POST merge și abia al doilea dă eroare?

Primul inserează rândul cu cheia trimisă de client. Al doilea trimite aceeași cheie (sau una deja generată), iar tabelul o are deja.

Ce înseamnă over-posting?

Clientul trimite câmpuri pe care nu ar trebui să le controleze (Id, EsteAdmin, Pret), iar API-ul le acceptă pentru că leagă corpul direct de entitate. DTO-urile cu doar câmpurile permise previn atât erorile, cât și problemele de securitate.

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.