ASP.NET Core Web API EF一对多关联未返回预期结果

以下是几个排查和解决的关键点：

1. 确认模型关系配置正确 #

首先要保证Merchant和MerchantUser的导航属性、外键配置无误：

• Merchant模型：必须包含指向MerchantUser集合的导航属性

  public class Merchant
  {
      public int Id { get; set; }
      // 其他业务属性
      public ICollection<MerchantUser> MerchantUsers { get; set; } = new List<MerchantUser>();
  }
  

• MerchantUser模型：需要包含指向Merchant的外键和导航属性，同时关联ApplicationUser

  public class MerchantUser
  {
      public int Id { get; set; }
      public int MerchantId { get; set; } // 关联Merchant的外键
      public Merchant Merchant { get; set; } // 导航属性
      
      public string ApplicationUserId { get; set; } // 关联Identity用户的外键
      public ApplicationUser ApplicationUser { get; set; }
  }
  

• DbContext配置：在OnModelCreating中明确一对多关系（如果不用数据注解的话）

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      base.OnModelCreating(modelBuilder); // 必须保留，确保Identity配置生效
      
      modelBuilder.Entity<Merchant>()
          .HasMany(m => m.MerchantUsers)
          .WithOne(mu => mu.Merchant)
          .HasForeignKey(mu => mu.MerchantId)
          .OnDelete(DeleteBehavior.Cascade);
  }
  

2. 检查Include/ThenInclude的使用是否正确 #

仓储方法中必须显式指定要加载的导航属性，如果需要同时加载MerchantUser关联的ApplicationUser，还要用ThenInclude：

// 单个Merchant查询示例
public async Task<Merchant> GetMerchantWithUsersAsync(int merchantId)
{
    return await _context.Merchants
        .Include(m => m.MerchantUsers) // 加载当前Merchant下的所有MerchantUser
            .ThenInclude(mu => mu.ApplicationUser) // 进一步加载每个MerchantUser对应的ApplicationUser
        .FirstOrDefaultAsync(m => m.Id == merchantId);
}

// 批量查询示例
public async Task<List<Merchant>> GetAllMerchantsWithUsersAsync()
{
    return await _context.Merchants
        .Include(m => m.MerchantUsers)
            .ThenInclude(mu => mu.ApplicationUser)
        .ToListAsync();
}

注意：如果只写Include(m => m.MerchantUsers)，只会加载MerchantUser数据，不会自动加载它关联的ApplicationUser。

3. 修复JSON序列化问题 #

ASP.NET Core默认的System.Text.Json可能会因为循环引用或序列化规则导致关联数据不显示，需要在Program.cs中配置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 忽略循环引用（比如Merchant和MerchantUser互相引用时会触发）
        options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
        // 仅在属性为null时才忽略序列化，空集合会正常显示
        options.JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull;
    });

另外要确保所有导航属性都是public访问修饰符，否则序列化器无法读取。

4. 排查延迟加载问题 #

EF Core默认关闭延迟加载，如果你的项目开启了延迟加载，但仓储方法执行完毕后DbContext被释放（比如仓储是Scoped生命周期），那么序列化时尝试延迟加载会失败，导致关联数据为null：

• 不需要延迟加载的话，保持默认配置即可，用Include显式加载数据；
• 必须用延迟加载的话，要确保DbContext在序列化完成前保持存活（不推荐此方式，显式加载更可控）。

5. 验证查询结果 #

在仓储方法中打个断点，查看查询到的Merchant对象的MerchantUsers集合是否有数据：

• 如果内存中对象有数据但序列化后没有，那是序列化配置问题；
• 如果内存中就没有数据，说明查询或模型关系配置有误，检查数据库中MerchantUser表的MerchantId是否正确关联到Merchant表的主键。

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