ASP.NET Core 5中EF配置一对多关系查询Article表Include报错如何解决

核心修正步骤 #

1. 修正Article实体类的导航属性与外键配置 #

确保Article实体类的字段名、外键名和SQL Server中Article表结构完全一致，正确配置和Category的关联：

public class Article
{
    // 其余Article字段需和数据库表字段一一对应，字段名完全匹配
    public int idcategory { get; set; }
    // 导航属性，用于Include查询
    public Category Category { get; set; }
}

2. 修正Include查询写法 #

控制器中调用Include方法时，参数必须和Article类中定义的导航属性名称完全匹配：

// 正确写法，导航属性名为Category
var articles = _context.Article
    .Include(a => a.Category)
    .ToList();

不推荐使用字符串形式的重载，容易出现拼写错误导致Include失效。

3. 修正AutoMapper映射配置 #

如果使用AutoMapper映射到ArticlesViewModel，需显式配置关联Category字段的映射规则：

CreateMap<Article, ArticlesViewModel>()
    // 示例：将关联分类的名称映射到ViewModel的CategoryName字段，可根据你的ViewModel字段调整
    .ForMember(dest => dest.CategoryName, opt => opt.MapFrom(src => src.Category.namecategory))
    // 其余字段映射规则
    ;

未配置关联字段映射会导致映射报错或ViewModel中分类字段为空。

4. 修正DbContext关联配置 #

在DbContextSystem的OnModelCreating方法中显式配置两个实体的关联关系，适配现有数据库的外键规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 显式指定实体对应表名，避免EF Core自动生成错误表名
    modelBuilder.Entity<Article>().ToTable("Article");
    modelBuilder.Entity<Category>().ToTable("Category");

    // 配置Category和Article的一对多关联
    modelBuilder.Entity<Category>(entity =>
    {
        entity.HasMany(c => c.articles)
            .WithOne(a => a.Category)
            .HasForeignKey(a => a.idcategory)
            // 如果Article表的idcategory字段为非必填，移除下面这行
            .IsRequired();
    });
}

5. 处理循环引用报错 #

如果序列化时出现循环引用报错，是因为Category实体包含Article集合导航属性、Article实体包含Category导航属性导致的，优先采用只返回ViewModel的方式避免该问题，也可在服务注册时配置JSON序列化规则：

services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
    });

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