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.
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 exempluNotaIdpentru clasaNota.
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
public class Nota
{
public int NotaElev { get; set; }
public int Valoare { get; set; }
}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ă
public class Produs
{
public string Cod { get; set; } = "";
public string Nume { get; set; } = "";
}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
public class Client
{
public int Id;
public string Nume { get; set; } = "";
}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ă
public class InscriereCurs
{
public int ElevId { get; set; }
public int CursId { get; set; }
}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ă 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.
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>();
}GET /note → 200 OK ["1: Ana 9","2: Ion 7"]
Indiciu
Convenția EF recunoaște ca cheie o proprietate cu un anumit nume.
Reparația
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.Id).Select(n => $"{n.Id}: {n.Elev} {n.Valoare}").ToList());
app.Run();
public class Nota
{
public int Id { 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>();
}De ce merge
Proprietatea NotaElev nu se potrivește convenției (Id sau NotaId), deci EF nu avea cheie primară pentru Nota și refuza să construiască modelul. Redenumită Id, devine cheia, iar pentru că e int, EF îi generează valori 1, 2... la SaveChanges. Puteai la fel de bine să păstrezi numele și să pui [Key] pe ea. Endpoint-ul ordonează după cheie și afișează fiecare notă.
Cum o eviți pe viitor
- Folosește convenția
Idsau<Clasa>Idpentru cheie; e cea mai simplă variantă. - Pentru alt nume sau chei compuse, configurează explicit cu
[Key],[PrimaryKey(...)]sauHasKey. - 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. Î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.
