System.InvalidOperationException: The seed entity for entity type 'Carte' cannot be added because a non-zero value is required for property 'Id'. Consider providing a negative value to avoid collisions with non-seed data.
Datele din HasData trebuie să aibă cheia primară setată explicit, chiar dacă în rest baza o generează automat. Dă fiecărui obiect din HasData un Id fix (1, 2, 3...), ca migrările să poată recunoaște rândurile între versiuni.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
HasData declară date inițiale („seed”) în model. Ele ajung în migrări (sau sunt inserate de EnsureCreated) ca instrucțiuni INSERT, iar la migrările următoare EF compară datele vechi cu cele noi ca să genereze UPDATE sau DELETE. Pentru asta trebuie să știe exact care rând e care, deci cheia primară trebuie dată explicit, nu generată de bază.
Dacă lași Id la valoarea implicită (0 pentru int), EF aruncă această excepție când construiește modelul, adică la prima folosire a contextului sau la dotnet ef migrations add.
Sugestia cu valori negative din mesaj se referă la tabelele în care și aplicația inserează rânduri: o cheie de seed negativă nu se va ciocni niciodată cu cheile generate de bază (care încep de la 1). Pentru tabele de referință (categorii, țări, roluri), valorile 1, 2, 3... sunt de obicei suficiente.
Aceeași regulă se aplică și cheilor străine: în HasData le setezi ca valori (CategorieId = 1), nu prin obiecte de navigare.
De ce apare: cauzele frecvente
1Seed fără cheie
m.Entity<Carte>().HasData(
new Carte { Titlu = "Moromeții" });m.Entity<Carte>().HasData(
new Carte { Id = 1, Titlu = "Moromeții" });Cu cheia fixă, EF poate insera rândul și îl poate recunoaște la migrările următoare.
2Navigare în loc de cheie străină
m.Entity<Produs>().HasData(
new Produs { Id = 1, Nume = "Mouse", Categorie = new Categorie { Id = 1 } });m.Entity<Categorie>().HasData(new Categorie { Id = 1, Nume = "IT" });
m.Entity<Produs>().HasData(
new Produs { Id = 1, Nume = "Mouse", CategorieId = 1 });HasData nu urmează navigările: fiecare entitate se declară separat, iar legăturile se fac prin valoarea cheii străine.
3Seed peste date generate de aplicație
new Rol { Id = 1, Nume = "admin" }new Rol { Id = -1, Nume = "admin" }Cu cheie negativă, rândul de seed nu se ciocnește cu rândurile create de aplicație, care primesc chei pozitive.
Repară eroarea, direct în pagină
Aplicația nu pornește: The seed entity for entity type 'Carte' cannot be added because a non-zero value is required for property 'Id'. Repară datele din HasData ca GET /carti să afișeze cele două cărți, numerotate 1 și 2.
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())
{
scope.ServiceProvider.GetRequiredService<Biblioteca>().Database.EnsureCreated();
}
app.MapGet("/carti", (Biblioteca db) => db.Carti.OrderBy(c => c.Id).Select(c => $"{c.Id}. {c.Titlu} - {c.Autor}").ToList());
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>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Carte>().HasData(
new Carte { Titlu = "Enigma Otiliei", Autor = "George Călinescu" },
new Carte { Titlu = "Moromeții", Autor = "Marin Preda" });
}
}GET /carti → 200 OK ["1. Enigma Otiliei - George Călinescu","2. Moromeții - Marin Preda"]
Indiciu
Fiecare obiect din HasData are nevoie de cheia primară setată explicit.
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())
{
scope.ServiceProvider.GetRequiredService<Biblioteca>().Database.EnsureCreated();
}
app.MapGet("/carti", (Biblioteca db) => db.Carti.OrderBy(c => c.Id).Select(c => $"{c.Id}. {c.Titlu} - {c.Autor}").ToList());
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>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Carte>().HasData(
new Carte { Id = 1, Titlu = "Enigma Otiliei", Autor = "George Călinescu" },
new Carte { Id = 2, Titlu = "Moromeții", Autor = "Marin Preda" });
}
}De ce merge
EF trebuie să identifice stabil fiecare rând de seed, ca să-l poată compara între migrări, de aceea cere cheia primară explicită, chiar dacă la inserările obișnuite o generează baza. Cu Id = 1 și Id = 2, modelul se construiește, EnsureCreated() inserează cele două cărți, iar endpoint-ul le afișează în ordine.
Alte forme ale mesajului
The seed entity for entity type 'Produs' cannot be added because no value was provided for the required property 'Nume'.The seed entity for entity type 'Produs' with the key value 'Id:1' cannot be added because it has the navigation 'Categorie' set. To seed relationships, add the entity seed to 'Categorie' and specify the foreign key values {'CategorieId'}.
Cum o eviți pe viitor
- În
HasDatasetează mereu cheia primară și cheile străine explicit. - Nu schimba cheile datelor de seed odată ce au ajuns în producție: migrarea le-ar șterge și reinsera.
- Pentru date de test sau volume mari, folosește un seed în cod (la pornire, cu verificare de existență), nu
HasData.
Întrebări frecvente
De ce aici trebuie cheia, dacă la Add o generează baza?
La Add, rândul e inserat o singură dată, iar EF află cheia după SaveChanges. Datele din HasData sunt parte din model și sunt comparate între migrări, deci au nevoie de o identitate stabilă, cunoscută dinainte.
Datele din HasData apar fără EnsureCreated sau migrare?
Nu. Ele sunt inserate doar de EnsureCreated() (la crearea bazei) sau de migrarea care le conține. Un context folosit direct, fără una dintre ele, nu le vede.
Erori înrudite
System.InvalidOperationException: The entity type 'Nota' requires a primary key to be defined. If you intended to use a keyless entity type, call 'HasNoKey' in 'OnModelCreating'. For more information on keyless entity types, see https://go.microsoft.com/fwlink/?linkid=2141943. EF Core nu a găsit cheia primară a entității. Numește proprietatea Id sau <Clasa>Id (de exemplu NotaId), pune [Key] pe ea sau configureaz-o cu HasKey în OnModelCreating. Pentru tabele fără cheie (vederi, rapoarte) folosește HasNoKey. System.InvalidOperationException: Relational-specific methods can only be used when the context is using a relational database provider. Ai apelat o metodă care există doar pentru baze relaționale (Migrate, ExecuteSqlRaw, GetDbConnection, FromSql...) pe un context configurat cu UseInMemoryDatabase. Pe InMemory folosește EnsureCreated și LINQ, sau testează cu SQLite în memorie. Î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.
