Database First模式ASP.NET MVC Core外键导航属性为null如何解决

EF Core 默认不会自动加载关联的导航属性，你遇到的Role为null属于未正确配置关联数据加载逻辑导致的，核心原因分3种：

• 未使用急加载主动声明要加载的导航属性，查询User时EF Core只会读取tbUser表的字段，不会自动关联查询tbRole表
• 未启用懒加载配置，EF Core默认关闭懒加载功能，即便配置了正确的外键关系，访问导航属性时也不会自动触发关联查询
• 未对特定实体手动执行显式加载操作

方法1：使用急加载（推荐，性能最优） #

查询User时通过Include方法显式声明要关联加载的导航属性即可，示例代码：

// 需引入命名空间 using Microsoft.EntityFrameworkCore;
var userList = _dbContext.Users
                .Include(u => u.Role) // 关联加载Role导航属性
                .ToList();

如果需要加载多层嵌套的导航属性，可搭配ThenInclude使用，该方案可以避免N+1查询问题，适合绝大多数场景。

方法2：配置懒加载 #

如果需要访问导航属性时自动触发关联查询，可以开启懒加载功能，操作步骤如下：

1. 安装NuGet包：Microsoft.EntityFrameworkCore.Proxies，版本要和你使用的EF Core版本一致
2. 配置DbContext启用懒加载代理，在Program.cs（.NET 6+）或者Startup.cs的DbContext配置处添加UseLazyLoadingProxies()：

builder.Services.AddDbContext<你的DbContext类名>(options =>
    options.UseSqlServer("你的数据库连接字符串")
           .UseLazyLoadingProxies() // 启用懒加载代理
);

3. 将实体类的导航属性修改为virtual：

[Table("tbUser")]
public class User
{
    // 其他属性不变
    [ForeignKey("RoleID")]
    public virtual Role Role { get; set; } // 加virtual修饰
}

[Table("tbRole")]
public class Role
{
    // 其他属性不变
    public virtual ICollection<User> Users { get; set; } // 加virtual修饰
}

注意该方案会在访问导航属性时自动触发额外的数据库查询，使用不当容易出现N+1性能问题。

方法3：显式加载 #

如果只需要给特定的单个实体加载关联导航属性，可以手动触发加载操作，示例代码：

var user = _dbContext.Users.FirstOrDefault(u => u.UserID == 1);
// 手动加载当前user的Role导航属性
_dbContext.Entry(user).Reference(u => u.Role).Load();

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