Entity Framework Core：显式加载关联数据遇到问题

嘿，我来帮你搞定这个EF Core显式加载的问题！从你给出的类结构来看，核心问题大概率出在继承映射的配置或者显式加载的写法上——毕竟涉及抽象基类的导航属性，很容易踩坑。

先把你没写完的类补全（方便后续分析）：

public abstract class Wallet 
{
    #region Database Properties
    [Key]
    public string Address { get; set; }
    [Required]
    public DateTime CreatedDate { get; set; } = DateTime.UtcNow;
    #endregion

    #region Navigation Properties
    public List<WalletTransaction> WalletTransactions { get; set; }
    #endregion

    // 建议加构造函数初始化导航属性，避免NullReference
    protected Wallet()
    {
        WalletTransactions = new List<WalletTransaction>();
    }
}

public class UserWallet : Wallet 
{
    [Required]
    public int UserId { get; set; }
    // 假设你还有关联的User实体
    // public User User { get; set; }
}

public class WalletTransaction
{
    [Key]
    public int Id { get; set; }
    public string WalletAddress { get; set; } // 关联Wallet的外键
    public decimal Amount { get; set; }
    public DateTime TransactionDate { get; set; }

    // 回指Wallet的导航属性
    public Wallet Wallet { get; set; }
}

第一步：确认继承映射的配置 #

EF Core默认用**TPH（单表继承）**策略，所有子类数据存在同一个Wallets表，自动生成Discriminator列区分类型。如果你的DbContext没正确配置继承和关联，显式加载肯定会失效。

在你的DbContext中补充配置：

public class AppDbContext : DbContext
{
    public DbSet<Wallet> Wallets { get; set; }
    public DbSet<UserWallet> UserWallets { get; set; }
    public DbSet<WalletTransaction> WalletTransactions { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 显式配置TPH（可选，默认就是TPH，但明确写出来更清晰）
        modelBuilder.Entity<Wallet>()
            .HasDiscriminator<string>("WalletType")
            .HasValue<UserWallet>("UserWallet");

        // 配置Wallet和WalletTransactions的一对多关联
        modelBuilder.Entity<Wallet>()
            .HasMany(w => w.WalletTransactions)
            .WithOne(t => t.Wallet)
            .HasForeignKey(t => t.WalletAddress) // 指定外键字段
            .OnDelete(DeleteBehavior.Cascade);
    }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("你的连接字符串")
            // 开启日志，方便排查SQL生成问题
            .LogTo(Console.WriteLine, LogLevel.Information);
    }
}

第二步：正确的显式加载写法 #

显式加载是指先获取主实体，再单独加载关联数据，用Entry(entity).Collection(...).LoadAsync()的方式：

场景1：加载单个UserWallet的关联交易 #

// 先获取目标UserWallet
var targetWallet = await _dbContext.UserWallets
    .FirstOrDefaultAsync(w => w.UserId == 123);

if (targetWallet != null)
{
    // 显式加载关联的WalletTransactions
    await _dbContext.Entry(targetWallet)
        .Collection(w => w.WalletTransactions)
        .LoadAsync();
}

场景2：从基类Wallet中筛选UserWallet并加载关联 #

如果你是从DbSet<Wallet>查询，需要用OfType<UserWallet>筛选类型，再加载关联：

var userWallet = await _dbContext.Wallets
    .OfType<UserWallet>()
    .FirstOrDefaultAsync(w => w.UserId == 123);

if (userWallet != null)
{
    await _dbContext.Entry(userWallet)
        .Collection(w => w.WalletTransactions)
        .LoadAsync();
}

第三步：排查常见坑点 #

1. 导航属性未初始化：一定要在Wallet的构造函数里初始化WalletTransactions为new List<WalletTransaction>()，否则加载后可能还是null，触发空引用异常。
2. 外键不匹配：确保WalletTransaction的WalletAddress和Wallet的主键Address类型完全一致（都是string），并且模型配置中正确指定了外键。
3. 继承类型筛选错误：如果直接查DbSet<Wallet>，EF Core不会自动识别子类的导航属性，必须用OfType<UserWallet>过滤后再加载。

可选：急切加载替代显式加载 #

如果你不需要分开加载，也可以用Include直接在查询时加载关联数据（急切加载），写法更简单：

var walletWithTransactions = await _dbContext.UserWallets
    .Include(w => w.WalletTransactions)
    .FirstOrDefaultAsync(w => w.UserId == 123);

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