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

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.

Pe scurt

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.

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

Ce înseamnă

Fiecare entitate pe care EF Core o urmărește are nevoie de o cheie primară: după ea știe care rând din tabel corespunde cărui obiect, ce să actualizeze și ce să șteargă. Când construiește modelul (la prima folosire a contextului), EF caută cheia prin convenție:

  • o proprietate numită Id;
  • sau <NumeClasa>Id, de exemplu NotaId pentru clasa Nota.

Dacă nu găsește niciuna și nici nu ai configurat cheia explicit, aruncă această excepție, cu numele entității între apostrofuri. Nume ca NotaElev, Cod, IdNota sau un câmp public în loc de proprietate nu sunt recunoscute.

A doua propoziție îți oferă alternativa: dacă tabelul chiar nu are cheie (o vedere SQL, rezultatul unei proceduri), declari entitatea „keyless” cu HasNoKey(). Astfel de entități se pot doar citi, nu și modifica.

În ASP.NET Core eroarea apare la prima cerere sau la seed-ul de la pornire, oriunde contextul își construiește modelul.

De ce apare: cauzele frecvente

1Cheie cu nume nerecunoscut

Greșit
C#
public class Nota
{
    public int NotaElev { get; set; }
    public int Valoare { get; set; }
}
Corect
C#
public class Nota
{
    public int Id { get; set; }
    public int Valoare { get; set; }
}

Convenția recunoaște doar Id și NotaId. Orice alt nume trebuie declarat explicit.

2Cheie cu alt nume, dar marcată

Greșit
C#
public class Produs
{
    public string Cod { get; set; } = "";
    public string Nume { get; set; } = "";
}
Corect
C#
using System.ComponentModel.DataAnnotations;

public class Produs
{
    [Key]
    public string Cod { get; set; } = "";
    public string Nume { get; set; } = "";
}

[Key] (sau HasKey(p => p.Cod) în OnModelCreating) îi spune lui EF care proprietate e cheia.

3Câmp public în loc de proprietate

Greșit
C#
public class Client
{
    public int Id;
    public string Nume { get; set; } = "";
}
Corect
C#
public class Client
{
    public int Id { get; set; }
    public string Nume { get; set; } = "";
}

EF mapează implicit doar proprietăți. Un câmp public Id nu e văzut, deci entitatea pare fără cheie.

4Cheie compusă nedeclarată

Greșit
C#
public class InscriereCurs
{
    public int ElevId { get; set; }
    public int CursId { get; set; }
}
Corect
C#
protected override void OnModelCreating(ModelBuilder m)
{
    m.Entity<InscriereCurs>().HasKey(i => new { i.ElevId, i.CursId });
}

Tabelele de legătură au de obicei cheie compusă. Ea se poate declara doar cu HasKey (sau [PrimaryKey] din EF Core 7).

Repară tu

Repară eroarea, direct în pagină

Catalogul nu pornește: The entity type 'Nota' requires a primary key to be defined. Fă din Nota o entitate cu cheie, generată automat, ca GET /note să întoarcă cele două note, numerotate 1 și 2.

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

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

using (var scope = app.Services.CreateScope())
{
    var db = scope.ServiceProvider.GetRequiredService<Catalog>();
    db.Note.AddRange(new Nota { Elev = "Ana", Valoare = 9 }, new Nota { Elev = "Ion", Valoare = 7 });
    db.SaveChanges();
}

app.MapGet("/note", (Catalog db) => db.Note.OrderBy(n => n.NotaElev).Select(n => $"{n.NotaElev}: {n.Elev} {n.Valoare}").ToList());

app.Run();

public class Nota
{
    public int NotaElev { get; set; }
    public string Elev { get; set; } = "";
    public int Valoare { get; set; }
}

public class Catalog(DbContextOptions<Catalog> options) : DbContext(options)
{
    public DbSet<Nota> Note => Set<Nota>();
}
După reparație, programul afișează
GET /note → 200 OK
["1: Ana 9","2: Ion 7"]
Indiciu

Convenția EF recunoaște ca cheie o proprietate cu un anumit nume.

Cum o eviți pe viitor

  • Folosește convenția Id sau <Clasa>Id pentru cheie; e cea mai simplă variantă.
  • Pentru alt nume sau chei compuse, configurează explicit cu [Key], [PrimaryKey(...)] sau HasKey.
  • Declară toate coloanele ca proprietăți { get; set; }, nu câmpuri.
  • Pentru vederi sau rapoarte fără cheie folosește HasNoKey() și citește-le doar.

Întrebări frecvente

De ce apare abia la prima cerere, nu la compilare?

Modelul EF se construiește la rulare, prin reflecție, prima dată când folosești contextul. Compilatorul nu știe nimic despre convențiile EF, deci codul compilează fără probleme.

Cheia trebuie să fie int?

Nu. Poate fi int, long, Guid, string sau alt tip simplu. Pentru int, long și Guid, EF generează automat valoarea la adăugare; pentru string trebuie să o setezi tu.

Erori înrudite

System.InvalidOperationException: No database provider has been configured for this DbContext. A provider can be configured by overriding the 'DbContext.OnConfiguring' method or by using 'AddDbContext' on the application service provider. If 'AddDbContext' is used, then also ensure that your DbContext type accepts a DbContextOptions<TContext> object in its constructor and passes it to the base constructor for DbContext. DbContext-ul nu știe la ce bază de date să se conecteze. Alege providerul în AddDbContext (UseSqlServer, UseNpgsql, UseSqlite sau UseInMemoryDatabase) și asigură-te că AppDb primește DbContextOptions<AppDb> în constructor și le trimite la base(options). 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. System.ArgumentException: Entity type 'Inscriere' is defined with a 2-part composite key, but 1 values were passed to the 'Find' method. Find primește valorile cheii primare în ordinea din HasKey, toate. Entitatea are cheie compusă din 2 coloane, iar tu ai dat o singură valoare. Apelează Find(elevId, cursId), sau folosește FirstOrDefault cu condiții dacă vrei să cauți după o parte a cheii.

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