AutoMapper ProjectTo<>无法映射自引用类型Parent的问题

问题场景 #

源/目标实体类型 #

// 源实体
public class Client
{
    //...
    public int Id { get; set; }
    public int? ParentId { get; set; }
    public Client? Parent { get; set; }
}

// 目标DTO
public class ClientDto
{
    //...
    public int Id { get; set; }
    public int? ParentId { get; set; }
    public ClientDto? Parent { get; set; }
}

AutoMapper配置 #

public class DtoProfiles : Profile
{
    public DtoProfiles()
    {
        //...
        CreateMap<Client, ClientDto>();
    }
}

查询代码 #

public async Task<ClientDto?> GetClient(int id)
{
    var clientDto = await context.Clients
        .ProjectTo<ClientDto>(mapper.ConfigurationProvider)
        .FirstOrDefaultAsync(c => c.Id == id);

    // clientDto.Parent 始终为 null
    return clientDto;
}

使用版本：AutoMapper v12.0.0、EF Core v7.0.3，其他属性映射正常，但自引用的Parent属性始终为null。

原因分析 #

• 导航属性未被加载：Parent属于EF Core实体的导航属性，ProjectTo基于查询投影实现，懒加载不会生效，若查询未显式包含该属性，数据库不会返回Parent数据，映射后自然为null。
• 实体关联关系未正确配置：如果DbContext中未为Parent导航属性配置对应的外键关联，EF Core无法识别这是关联关系，ProjectTo无法生成SQL Join语句获取Parent数据。
• 自引用映射的隐式限制：AutoMapper默认自动映射同名属性，但需要EF Core能正确解析关联关系，否则无法生成正确的投影查询。

解决方法 #

方法一：查询时显式包含导航属性 #

在查询中使用Include强制加载Parent导航属性，确保EF Core关联查询Parent表：

public async Task<ClientDto?> GetClient(int id)
{
    var clientDto = await context.Clients
        .Include(c => c.Parent) // 显式包含Parent导航属性
        .ProjectTo<ClientDto>(mapper.ConfigurationProvider)
        .FirstOrDefaultAsync(c => c.Id == id);

    return clientDto;
}

若需加载多级Parent（如Parent的Parent），可叠加ThenInclude：

.Include(c => c.Parent)
    .ThenInclude(p => p.Parent)

方法二：配置正确的实体关联关系 #

在DbContext的OnModelCreating方法中，明确配置Parent导航属性的外键关联：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Client>()
        .HasOne(c => c.Parent)
        .WithMany() // 若Client有Children导航属性，改为.WithMany(c => c.Children)
        .HasForeignKey(c => c.ParentId)
        .OnDelete(DeleteBehavior.Restrict); // 根据业务需求设置删除规则
}

配置完成后，AutoMapper的ProjectTo会自动生成对应的SQL Join语句，无需手动Include。

方法三：显式配置AutoMapper自引用映射 #

虽然AutoMapper默认会映射，但显式配置可提升代码可读性，确保嵌套映射生效：

public class DtoProfiles : Profile
{
    public DtoProfiles()
    {
        CreateMap<Client, ClientDto>()
            .ForMember(dest => dest.Parent, opt => opt.MapFrom(src => src.Parent));
        // AutoMapper会自动递归处理多级自引用，前提是EF Core加载了对应数据
    }
}

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