Entity Framework报错：关键组件‘Id’并非类型已声明属性

Let's break down what's happening here and how to fix it:

Why This Error Happens #

Your base Entity class marks the Id property with [NotMapped] — that tells Entity Framework to ignore this property entirely when mapping to the database. The actual property that interacts with the database is the internal ID property. But when you set up your model configuration in OnModelCreating, you're probably trying to use Id as the primary key for your entities. Since EF doesn't recognize Id as a mapped property (thanks to [NotMapped]), it throws that error.

Solutions #

1. Correct the Primary Key Configuration in Fluent API #

Instead of referencing Id in your configuration, point to the internal ID property. Since it's an internal member, you can specify it by name in the Fluent API:

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
    // Configure primary key for all entities inheriting from Entity
    modelBuilder.Types<Entity>()
        .Configure(entity => entity.HasKey("ID"));

    // Or configure it for a specific entity like AccountingTransaction
    modelBuilder.Entity<AccountingTransaction>()
        .HasKey("ID");
}

2. Refactor the Base Class (Cleaner Approach) #

If you don't want to rely on string property names, you can adjust the base class to make EF's job easier while keeping the ulong Id exposed:

public abstract class Entity 
{ 
    public virtual ulong Id { get; set; } 

    // Mark this as the primary key and map it to the "Id" column in the database
    [Key]
    [Column("Id")]
    internal virtual long ID { 
        get { unchecked { return (long)Id; } } 
        set { unchecked { Id = (ulong)value; } } 
    } 
}

Then, you just need to explicitly tell EF to map the internal ID property (since internal members aren't picked up by default):

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
    modelBuilder.Types<Entity>()
        .Configure(entity => 
        {
            entity.Property("ID")
                .HasColumnName("Id")
                .IsRequired();
        });
}

3. Verify Your Configuration #

To make sure everything is set up correctly, you can validate your model during debugging:

// Add this to your DbContext to check for model errors
var validationErrors = this.Model.Validate();
if (validationErrors.Any())
{
    foreach (var error in validationErrors)
    {
        Debug.WriteLine(error.Message);
    }
}

That should resolve the "Key component not declared" error — the key was realizing that EF doesn't see the [NotMapped] Id property, so you need to target the actual mapped ID property in your configuration.

内容的提问来源于stack exchange，提问作者Kacper Werema