Mapper.CreateMap 报错

在使用 AutoMapper 进行对象映射时，Mapper.CreateMap 是一个核心方法，用于定义源对象和目标对象之间的映射规则，开发者在使用该方法时可能会遇到各种报错，本文将分析常见的 Mapper.CreateMap 报错原因及解决方案，帮助用户快速定位和解决问题。

未初始化 AutoMapper 导致的错误

问题描述：直接调用 Mapper.CreateMap 时，程序抛出 NullReferenceException 或 AutoMapperConfigurationException。
原因分析：AutoMapper 需要先完成初始化才能正常工作，如果未调用 Mapper.Initialize 或 MapperConfiguration 构建映射配置，Mapper 实例将为空。
解决方案：确保在使用 Mapper.CreateMap 之前初始化 AutoMapper。

Mapper.Initialize(cfg => cfg.CreateMap<SourceType, DestinationType>());  

或使用 MapperConfiguration 显式配置：

var config = new MapperConfiguration(cfg => cfg.CreateMap<SourceType, DestinationType>());  
IMapper mapper = config.CreateMapper();  

映射规则不匹配导致的编译或运行时错误

问题描述：属性名不一致、类型不兼容或缺少构造函数时，映射失败。
原因分析：AutoMapper 默认要求源对象和目标对象的属性名称和类型一致，若属性名不同或类型无法转换，需显式配置映射规则。
解决方案：

1. 自定义属性映射：

   cfg.CreateMap<SourceType, DestinationType>()  
   .ForMember(dest => dest.DestProp, opt => opt.MapFrom(src => src.SourceProp));  

2. 处理类型转换：

   cfg.CreateMap<string, int>().ConvertUsing(str => int.Parse(str));  

3. 验证配置：调用 Mapper.Configuration.AssertConfigurationIsValid() 检查映射规则是否完整。

重复映射配置导致的冲突

问题描述：多次调用 Mapper.CreateMap 时，程序抛出 AutoMapperConfigurationException。
原因分析：AutoMapper 不允许重复定义相同的映射规则，否则会引发配置冲突。
解决方案：

1. 检查代码中是否存在重复的映射配置,确保每个映射只定义一次。
2. 使用 MapperConfiguration 替代全局 Mapper，避免跨模块的配置冲突。

依赖注入（DI）集成时的错误

问题描述：在使用 DI 容器（如 ASP.NET Core 的 IServiceCollection）时，Mapper.CreateMap 未被正确注册。
原因分析：未将 IMapper 实例注册到 DI 容器中，导致依赖注入失败。
解决方案：

1. 在 Startup.cs 中注册 AutoMapper：

   services.AddAutoMapper(typeof(Startup));  

2. 确保所有映射类通过 AutoMapperProfile 继承并注册。

性能优化建议

频繁调用 Mapper.CreateMap 可能影响性能，建议：

1. 在应用启动时集中配置所有映射规则,避免运行时动态创建。
2. 使用 MapperConfiguration 缓存配置实例，减少重复初始化开销。

---

相关问答 FAQs

A1: 通常是因为未调用 Mapper.Initialize 或 MapperConfiguration 初始化映射规则，请确保在使用 Mapper.Map 前已定义源类型与目标类型的映射关系。

Q2: 如何处理复杂对象的嵌套映射？
A2: 使用 .ForMember 或 .ForPath 方法显式配置嵌套属性映射，

cfg.CreateMap<OuterSource, OuterDest>()  
   .ForMember(dest => dest.InnerProp, opt => opt.MapFrom(src => src.InnerSource.InnerProp));  

或使用 AutoMapper 的 ProjectTo 方法进行 LINQ 查询映射。