EF Core一对多关联报错：外键与主键类型不兼容，求不改主键的解决方案

问题说明 #

报错信息：
从'TMSGCategory.TemporaryMessage'到'TemporaryMessage.TMSGCategories'的关联，外键属性{'MsgCategoryId' : short}无法匹配主键{'Id' : int}，类型不兼容。请为此关联配置一个主体键或一组兼容的外键属性。

原配置代码：

public class TemporaryMessageConfiguration:IEntityTypeConfiguration<TemporaryMessage>
{
    public void Configure(EntityTypeBuilder<TemporaryMessage> builder)
    {
        builder.HasKey(x => x.Id);

        builder.HasMany(a => a.TMSGCategories).WithOne(a => 
        a.TemporaryMessage).HasForeignKey(a => a.MsgCategoryId);
        
    }
}
public class TMSGCategoryConfiguration:IEntityTypeConfiguration<TMSGCategory>
{
    public void Configure(EntityTypeBuilder<TMSGCategory> builder)
    {   
        builder.HasKey(x => x.MsgCategoryId);
        builder.HasOne(a => a.TemporaryMessage).WithMany(a => a.TMSGCategories);
    }
}

解决步骤 #

1. 修正实体类字段
   在TMSGCategory中新增与TemporaryMessage.Id类型匹配的外键字段（int类型），不要用自身主键作为关联外键：

public class TMSGCategory
{
    public short MsgCategoryId { get; set; } // 原有主键，保持short类型不变
    public int TemporaryMessageId { get; set; } // 新增外键，类型与TemporaryMessage.Id一致
    public TemporaryMessage TemporaryMessage { get; set; }
    // 其他业务属性...
}

2. 修改EF Core配置类

• 更新TemporaryMessageConfiguration，指定正确的外键字段：

public class TemporaryMessageConfiguration:IEntityTypeConfiguration<TemporaryMessage>
{
    public void Configure(EntityTypeBuilder<TemporaryMessage> builder)
    {
        builder.HasKey(x => x.Id);

        builder.HasMany(a => a.TMSGCategories)
               .WithOne(a => a.TemporaryMessage)
               .HasForeignKey(a => a.TemporaryMessageId); // 替换为新增的外键字段
    }
}

• 更新TMSGCategoryConfiguration，明确关联的外键：

public class TMSGCategoryConfiguration:IEntityTypeConfiguration<TMSGCategory>
{   
    public void Configure(EntityTypeBuilder<TMSGCategory> builder)
    {   
        builder.HasKey(x => x.MsgCategoryId);
        builder.HasOne(a => a.TemporaryMessage)
               .WithMany(a => a.TMSGCategories)
               .HasForeignKey(a => a.TemporaryMessageId); // 指定正确的外键
    }
}

问题根源 #

原配置错误地将TMSGCategory的主键（short类型）作为关联TemporaryMessage的外键，而TemporaryMessage的主键是int类型，两者类型不兼容导致报错。通过新增类型匹配的外键字段，即可在保留原有主键类型的前提下完成关联配置。

内容的提问来源于stack exchange，提问作者mahdi salkhordeh