System.ArgumentException: An item with the same key has already been added. Key: 1
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
app.MapPost("/carti", (Carte carte, Biblioteca db) =>
{
db.Carti.Add(carte);
db.SaveChanges();
});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
db.Carti.Add(new Carte { Id = db.Carti.Count(), Titlu = t });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
var dupaAutor = carti.ToDictionary(c => c.Autor);var dupaAutor = carti.GroupBy(c => c.Autor)
.ToDictionary(g => g.Key, g => g.ToList());Când cheia se poate repeta, grupează întâi.
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.
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>();
}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.
Reparația
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", (CarteNoua date, Biblioteca db) =>
{
var carte = new Carte { Titlu = date.Titlu, Autor = date.Autor };
db.Carti.Add(carte);
db.SaveChanges();
return Results.Created($"/carti/{carte.Id}", carte);
});
app.Run();
public record CarteNoua(string Titlu, string Autor);
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>();
}De ce merge
Endpoint-ul lega corpul direct de entitate, deci "id": 1 trimis de client ajungea la Add, iar cheia 1 exista deja. Cu CarteNoua(Titlu, Autor), id-ul din JSON e pur și simplu ignorat, iar EF generează următoarea cheie liberă (2). În plus, clientul nu mai poate alege sau suprascrie chei.
Alte forme ale mesajului
Microsoft.EntityFrameworkCore.DbUpdateException: An item with the same key has already been added. Key: 1System.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ă
Idla creare; nu lega entitățile direct de corpul cererii. - Lasă baza să genereze cheile (
int/longidentity,Guid). - Pentru „creează sau actualizează”, verifică existența și decide explicit.
- În cod obișnuit, folosește
TryAddsau 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
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. System.InvalidOperationException: The instance of entity type 'Carte' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the conflicting key values. Contextul urmărește deja un obiect cu aceeași cheie, iar tu încerci să atașezi (Update, Attach, Add) un al doilea obiect cu aceeași cheie. Modifică obiectul deja încărcat, copiază valorile cu Entry(existent).CurrentValues.SetValues(date) sau citește cu AsNoTracking. Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException: Attempted to update or delete an entity that does not exist in the store. SaveChanges a încercat să actualizeze sau să șteargă un rând care nu (mai) există. Apare tipic când faci Update sau Remove pe un obiect construit din cerere, cu un id inexistent. Încarcă întâi entitatea, răspunde 404 dacă lipsește, apoi modific-o. Î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.
