AutoMapper MapFrom与EF Core ProjectTo无法填充目标属性问题

问题描述 #

配置AutoMapper将Customer实体映射到CustomerLookupListItem DTO，其中Postcode属性映射自Customer.HeadOfficeAddress.PostCode，但使用EF Core的ProjectTo<T>方法时，Postcode始终为null，生成的SQL也未查询该字段。已确认映射Profile的构造函数被调用，其他场景下类似的MapFrom+ProjectTo用法正常。

原因分析 #

从提供的AutoMapper DebugView可以看出：

• 内存映射的执行计划中包含Postcode的正确映射逻辑
• 但用于EF查询的投影表达式（Select部分）未包含Postcode的赋值逻辑

这说明映射配置虽然存在，但未被正确应用到EF的表达式树转换过程中，可能的诱因包括：

• 用于ProjectTo的ConfigurationProvider实例未加载目标Profile
• 存在重复的映射配置覆盖了当前规则
• AutoMapper与EF Core版本不兼容
• 导航属性的表达式树解析存在异常

解决方案 #

1. 验证映射配置有效性 #

在应用启动阶段添加配置验证，快速定位映射错误：

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.AddProfile<CustomerLookupListItemMappingProfile>();
});
// 若配置存在问题，会抛出AutoMapperConfigurationException
mapperConfig.AssertConfigurationIsValid();

2. 确认ConfigurationProvider实例一致性 #

确保ProjectTo使用的ConfigurationProvider与加载Profile的是同一个实例。在依赖注入场景下，需保证IMapper注册为单例：

// ASP.NET Core DI注册示例
services.AddAutoMapper(typeof(CustomerLookupListItemMappingProfile));
services.AddSingleton<IMapper>(sp => 
    new Mapper(sp.GetRequiredService<IConfigurationProvider>())
);

3. 排查重复映射配置 #

检查是否存在其他Profile或代码定义了Customer到CustomerLookupListItem的映射，避免配置被覆盖：

var duplicateMaps = mapper.ConfigurationProvider.GetAllTypeMaps()
    .Where(t => t.SourceType == typeof(Customer) && t.DestinationType == typeof(CustomerLookupListItem));
// 若返回数量大于1，说明存在重复映射

4. 调整映射配置写法 #

尝试使用ResolveUsing替代MapFrom，显式处理导航属性的null情况：

public class CustomerLookupListItemMappingProfile : Profile
{
    public CustomerLookupListItemMappingProfile()
    {
        CreateMap<Customer, CustomerLookupListItem>()
            .ForMember(dst => dst.Postcode, opt => opt.ResolveUsing(src => src.HeadOfficeAddress?.PostCode));
    }
}

5. 检查版本兼容性 #

确保AutoMapper与EF Core版本匹配：

• AutoMapper 12.x → EF Core 6.0+
• AutoMapper 11.x → EF Core 5.0+
  若版本不兼容，升级或降级到对应版本。

6. 临时 workaround：手动投影 #

如果以上方法均无效，可以绕过AutoMapper，手动编写投影逻辑：

public async Task<List<CustomerLookupListItem>> GetCustomerPostcodeAutocompleteAsync(String startsWith, Boolean activeOnly)
    => await dbContext.Customers.AsNoTracking()
        .Where(c => !activeOnly || c.isActive && c.HeadOfficeAddress.PostCode.StartsWith(startsWith))
        .OrderBy(c => c.HeadOfficeAddress.PostCode)
        .Select(c => new CustomerLookupListItem
        {
            CustomerID = c.CustomerID.Value,
            CustomerName = c.CustomerName,
            Nickname = c.Nickname,
            IsActive = c.isActive,
            Postcode = c.HeadOfficeAddress.PostCode
        })
        .ToListAsync();

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