AutoMapper内联映射报错“映射器未初始化”问题求助

你遇到的这个问题，大概率是AutoMapper版本差异导致的用法不匹配——毕竟AutoMapper在9.0版本之后做了重大调整，废弃了静态Mapper类的使用，而你可能参考的是旧版文档，但实际用的是新版库。下面分两种情况给你解决思路：

情况1：你使用的是AutoMapper 8.x及更早版本 #

虽然文档说明首次调用Mapper.Map会自动创建映射配置，但有些场景下静态Mapper仍需要先完成初始化。你只需要在应用启动的入口处（比如Program.cs、Startup.cs）添加一次全局初始化代码即可：

// 全局仅需初始化一次，无需手动添加具体映射规则
Mapper.Initialize(cfg => { });

// 之后在你的API包装器类里正常调用映射
var domainModel = Mapper.Map<DomainModel>(apiModel);

这样就能触发内联映射的自动创建逻辑，不会再报“映射器未初始化”的错误。

情况2：你使用的是AutoMapper 9.0+版本（推荐的现代用法） #

从9.0版本开始，AutoMapper彻底移除了静态Mapper类的支持，必须使用实例化的IMapper来完成映射，哪怕是内联映射也不例外。正确的做法分为两种场景：

方式一：手动创建实例（适合非依赖注入场景） #

// 1. 创建Mapper配置（全局仅需创建一次，可复用）
var mapperConfig = new MapperConfiguration(cfg => {
    // 内联映射不需要手动添加任何映射规则，这里可以留空
    // 也可以添加全局配置，比如忽略null值、自定义类型转换器等
});

// 2. 创建IMapper实例
var mapper = mapperConfig.CreateMapper();

// 3. 在包装器中使用实例进行映射
var domainModel = mapper.Map<DomainModel>(apiModel);

方式二：依赖注入（适合ASP.NET Core等DI场景） #

如果你的项目使用依赖注入，推荐在启动时注册AutoMapper服务，然后通过构造函数注入IMapper：

// 在Startup.cs的ConfigureServices方法中注册AutoMapper
services.AddAutoMapper(typeof(Startup)); // 自动扫描项目配置，内联映射无需额外设置

// 在你的API包装器类中注入IMapper
public class ApiWrapper
{
    private readonly IMapper _mapper;

    public ApiWrapper(IMapper mapper)
    {
        _mapper = mapper;
    }

    public DomainModel ConvertApiModel(ApiModel apiModel)
    {
        return _mapper.Map<DomainModel>(apiModel);
    }
}

关键提醒 #

先确认你当前使用的AutoMapper版本：打开NuGet包管理器，查看AutoMapper的版本号，再对应上面的方案调整代码。新版本的设计更符合依赖注入的理念，也更易于测试和维护，建议优先采用9.0+的实例化用法。

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