启用LazyLoadingProxies后未用Include却自动加载关联数据问题

你遇到的情况并非查询阶段主动加载了关联数据，而是延迟加载的触发逻辑导致的，具体原因和解决办法如下：

核心原因 #

1. 延迟加载的触发时机：启用LazyLoadingProxies且导航属性标记为virtual时，EF Core会为实体生成代理类。当你在代码中（包括调试查看、序列化、业务逻辑处理）访问Role.Users属性的瞬间，EF Core会自动执行额外SQL查询加载关联数据，而非在ToList()执行时就完成加载。
2. 序列化自动触发：如果将查询到的Role对象序列化为JSON（比如接口返回给前端），序列化器会遍历所有属性，包括virtual的Users，这会直接触发延迟加载。
3. 调试器预览触发：调试时若展开Role对象查看Users属性，调试器会触发属性访问逻辑，进而触发延迟加载。

解决办法 #

根据你的实际场景选择对应方案：

1. 避免不必要的属性访问 #

检查代码中是否在查询Role后主动访问了Users属性，调试时不要随意展开该属性查看内容。

2. 阻止序列化触发加载 #

如果是序列化导致的关联数据加载，可采用以下方式：

• 使用DTO传输数据：创建仅包含所需字段的RoleDto，映射后返回，避免直接序列化实体对象：

  public class RoleDto
  {
      public int Id { get; set; }
      public string Name { get; set; }
      public string Description { get; set; }
      // 按需决定是否包含Users字段
  }
  
  // 查询时做映射
  public List<RoleDto> FindAll()
      => context.Role.Select(r => new RoleDto
      {
          Id = r.Id,
          Name = r.Name,
          Description = r.Description
      }).ToList();
  

• 添加序列化忽略注解：在Users属性上添加[JsonIgnore]（适配Newtonsoft.Json或System.Text.Json）：

  public class Role : DomainEntity<int>
  {
      public string Name { get; set; }
      public string Description { get; set; }
  
      [JsonIgnore]
      public virtual ICollection<User> Users { get; set; }
  }
  

3. 禁用当前查询的代理/跟踪 #

使用AsNoTracking()让EF Core不生成代理对象，从而阻止延迟加载：

public List<Role> FindAll()
    => context.Role.AsNoTracking().ToList();

4. 移除导航属性的virtual修饰符 #

如果该导航属性不需要延迟加载，直接去掉virtual关键字，即使全局启用了LazyLoadingProxies，这个属性也不会触发延迟加载：

public class Role : DomainEntity<int>
{
    public string Name { get; set; }
    public string Description { get; set; }

    public ICollection<User> Users { get; set; } // 移除virtual
}

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