ABP框架下AutoMapper映射失败问题排查（.NET Core 8）

我正在使用.NET Core 8开发ABP应用，定义了如下Member实体：

public class Member: AuditedAggregateRoot<Guid>
 {
     public string MembershipNo { get; set; }
     public string EmployeeNo { get; set; }
     public string FirstName { get; set; }
     public string MiddleName { get; set; }
     public string LastName { get; set; }
     public string Gender { get; set; }
     public DateTime DateOfBirth { get; set; }
     public DateTime EmploymentDate { get; set; }
     public string TelephoneNo { get; set; }
     public string PhyisicalAddress { get; set; }
     public string PostalAddress { get; set; }
     public string EmailAddress { get; set; }

 }

以及对应的MemberDto：

public class MemberDto : AuditedEntityDto<Guid>
{
    public string MembershipNo { get; set; }
    public string EmployeeNo { get; set; }
    public string FirstName { get; set; }
    public string MiddleName { get; set; }
    public string LastName { get; set; }
    public string Gender { get; set; }
    public DateTime DateOfBirth { get; set; }
    public DateTime EmploymentDate { get; set; }
    public string TelephoneNo { get; set; }
    public string PhyisicalAddress { get; set; }
    public string PostalAddress { get; set; }
    public string EmailAddress { get; set; }

}

我创建了如下AutoMapper配置文件：

public class AbpTestAutoMapperProfile : Profile
{
    public AbpTestAutoMapperProfile()
    {
        CreateMap<MemberDto, Member>().IgnoreAuditedObjectProperties() ;
        CreateMap<Member, MemberDto>().IgnoreAuditedObjectProperties();//.ForMember(dest => dest.Name, opt => opt.MapFrom(src => $"{src.FirstName} {src.MiddleName} {src.LastName}-({src.EmployeeNo})"));
        CreateMap<MemberDto, CreateUpdateMemberDto>();
        CreateMap<CreateUpdateMemberDto, Member>().IgnoreAuditedObjectProperties();
    }
}

并在模块中配置了AutoMapper：

Configure<AbpAutoMapperOptions>(options =>
{
    options.AddMaps<AppModule>();
    options.AddProfile<AbpTestAutoMapperProfile>();
});

但执行以下映射代码时：

var member = await _memberRepository.GetAsync(id);

var mbm = ObjectMapper.Map<Member, MemberDto>(member);

出现错误：Can not map from given object ([ENTITY: MemberProxy] Id = 95a81b14-c881-4d59-5fcb-3a12b307b806) to AbpTest.Contracts.MemberDto, AbpTest, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null。使用的Volo.Abp.AutoMapper版本为8.2.2，请问该错误的原因是什么？

• EF Core代理类映射支持缺失：错误中的MemberProxy表明从仓储获取的是EF Core动态代理对象，而非原始Member实体。AutoMapper默认可能未正确识别代理类与Dto的映射关系。
• AutoMapper配置冲突：模块中同时使用AddMaps<AppModule>()和AddProfile<AbpTestAutoMapperProfile>()，可能导致配置重复加载或自定义Profile未被正确注册。
• 审计属性映射逻辑错误：IgnoreAuditedObjectProperties()方法可能未正确处理AuditedAggregateRoot和AuditedEntityDto的审计属性，导致代理类的审计字段无法正常映射。

对应的解决步骤：

1. 调整模块AutoMapper配置：移除重复配置，只保留一种注册方式，避免冲突。例如：

Configure<AbpAutoMapperOptions>(options =>
{
    options.AddProfile<AbpTestAutoMapperProfile>();
});

2. 修正审计属性映射：改用ABP官方提供的MapAuditedProperties()方法替代IgnoreAuditedObjectProperties()，确保审计属性正确映射：

CreateMap<Member, MemberDto>().MapAuditedProperties();
CreateMap<MemberDto, Member>().MapAuditedProperties();

3. 确保代理类被识别：ABP的AutoMapper集成默认支持EF代理类映射，若仍有问题，可在映射配置中显式包含基类，或在获取实体时临时禁用代理（仅用于排查）：

var member = await _memberRepository.GetAsync(id, includeDetails: false);

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