ABP框架不自动注册使用自定义Mapper类的问题如何解决

根因说明 #

仅实现单个实体维度的IObjectMapper<HierachyItem, HierachyItemDto>映射接口时，ABP框架的自定义映射逻辑不会自动衍生支持IEnumerable<>、List<>等集合泛型类型的映射，无需为所有容器类型单独实现映射接口，可通过以下两种方案解决：

方案1：使用AutoMapper Profile统一配置（推荐） #

ABP默认集成AutoMapper作为底层映射提供者，配置Profile后可自动支持单个、集合、嵌套类型的全场景映射，无需单独编写自定义Mapper类：

1. 定义Profile类继承Profile，在构造函数内配置映射规则（包含你之前自定义Mapper中的特殊映射逻辑）：

public class HierachyItemProfile : Profile
{
    public HierachyItemProfile()
    {
        CreateMap<HierachyItem, HierachyItemDto>()
            // 示例：配置字段映射规则，按需替换为你的自定义逻辑
            .ForMember(dest => dest.NodeName, opt => opt.MapFrom(src => src.Name))
            .ForMember(dest => dest.ChildrenCount, opt => opt.MapFrom(src => src.Children.Count));
    }
}

2. 在对应模块的ConfigureServices方法中注册Profile：

Configure<AbpAutoMapperOptions>(options =>
{
    // 方式1：扫描当前模块所有Profile自动注册
    options.AddMaps<YourModuleName>();
    // 方式2：单独注册指定Profile，可开启映射校验
    options.AddProfile<HierachyItemProfile>(validate: true);
});

配置完成后无需修改现有业务代码，直接调用ObjectMapper.Map<IEnumerable<HierachyItem>, IEnumerable<HierachyItemDto>>(nodeList)即可正常执行。

方案2：保留现有自定义Mapper，调整调用写法 #

如果你不想改动已完成的自定义Mapper实现，无需单独实现集合映射接口，直接通过LINQ的Select方法调用单个实体映射即可，无需手写foreach循环：

var nodeListDto = nodeList.Select(ObjectMapper.Map<HierachyItem, HierachyItemDto>).ToList();

该写法与直接调用集合Map方法的效果、性能完全一致，仅调整了调用侧代码，不需要额外修改映射配置。

注：该表现为ABP框架的已知设计逻辑，自定义单个实体映射不会自动适配所有集合泛型类型，以上两种方案均可覆盖需求。

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