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

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.

Pe scurt

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

Greșit
C#
m.Entity<Carte>().HasData(
    new Carte { Titlu = "Moromeții" });
Corect
C#
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ă

Greșit
C#
m.Entity<Produs>().HasData(
    new Produs { Id = 1, Nume = "Mouse", Categorie = new Categorie { Id = 1 } });
Corect
C#
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

Greșit
C#
new Rol { Id = 1, Nume = "admin" }
Corect
C#
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ă tu

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.

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())
{
    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" });
    }
}
După reparație, programul afișează
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.

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 HasData setează 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

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