DotNET Scaffold因一对多关系实体无法生成代码的解决求助

刚从Java转用ASP.NET，按官方教程能正常生成控制器，但测试项目中当实体包含一对多集合（User对应多个Links）时生成失败，移除集合则恢复正常。执行控制器生成命令时报错：
Could not get the reflection type for DbContext : UserLinksDb

相关代码 #

User模型 #

public class UserItem
{
    [Key]
    public long UserId { get; set; }

    [Required]
    [MinLength(3, ErrorMessage = "Min 3 char")]
    [MaxLength(20)]
    public string? Name { get; set; }

    [Required]
    [MinLength(6, ErrorMessage = "Min 6 char"), MaxLength(20)]
    public required string Password { get; set; } // todo: private set;

    // [ForeignKey("Links")]
    // [ConcurrencyCheck]
    public ICollection<LinkItem> Links { get; set; }

    public UserItem()
    {
        Links = new List<LinkItem>();
    }
}

Link模型 #

public class LinkItem
{
    [Key]
    public long UserId { get; set; }
    [ForeignKey("UserId")]
    public UserItem? UserItem { get; set; }
    public string? Link { get; set; }
}

DbContext #

public class UserLinksDb : DbContext
{
    public UserLinksDb(DbContextOptions<UserLinksDb> options) : base(options) { }

    public DbSet<UserItem> UserItems { get; set; } = null!;
    public DbSet<LinkItem> LinkItems { get; set; } = null!;

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<LinkItem>().HasKey(k => k.UserId);
        modelBuilder.Entity<LinkItem>( e => 
        {
            e.HasKey(k => k.UserId);
            e.HasOne(k => k.UserItem)
            .WithMany(k => k.Links)
            .HasForeignKey(k => k.UserId)
            .OnDelete(DeleteBehavior.ClientSetNull);
        });
    }
}

内存数据库配置 #

builder.Services.AddDbContext<UserLinksDb>(option => option.UseInMemoryDatabase("LinksList"));

控制器生成命令 #

dotnet aspnet-codegenerator controller -name LinksController -async -api -m UserItem -dc UserLinksDb -outDir Controllers

解决步骤 #

1. 修正实体关系配置 #

你的LinkItem用UserId作为主键，这会导致一个用户只能对应一个链接（主键唯一），完全违背一对多的设计逻辑，这也是代码生成工具报错的核心原因。修改LinkItem添加独立主键：

public class LinkItem
{
    [Key]
    public long LinkId { get; set; } // 新增独立主键
    public long UserId { get; set; }
    [ForeignKey("UserId")]
    public UserItem? UserItem { get; set; }
    public string? Link { get; set; }
}

同时简化DbContext的OnModelCreating（删除重复的主键设置代码）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<LinkItem>(e => 
    {
        e.HasOne(k => k.UserItem)
         .WithMany(k => k.Links)
         .HasForeignKey(k => k.UserId)
         .OnDelete(DeleteBehavior.ClientSetNull);
    });
}

2. 清理并重建项目 #

执行以下命令确保项目编译状态正常：

dotnet clean
dotnet build

3. 重新执行生成命令 #

再次运行之前的控制器生成命令，此时应该能正常生成控制器。

额外检查 #

若仍报错，确认dotnet-aspnet-codegenerator工具版本与项目.NET版本兼容，不兼容则更新工具：

dotnet tool update --global dotnet-aspnet-codegenerator

内容的提问来源于stack exchange，提问作者Toran Lightleaf