如何在.NET Core环境下通过扩展方法使用AutoMapper 10?
.NET Core 与 AutoMapper 10 环境下兼容旧版扩展映射的实现方案
AutoMapper 10 及以上版本正式废弃了全局静态的AutoMapper.Mapper调用入口,官方推荐基于依赖注入管理映射实例,但可以通过以下步骤在不改动原有业务调用逻辑的前提下,实现和旧版完全一致的开发体验:
- 第一步:完成AutoMapper的基础依赖注入注册
引入匹配版本的AutoMapper.Extensions.Microsoft.DependencyInjection包,在应用启动配置阶段完成服务注册,和官方推荐写法保持一致:// .NET 6+ 顶级语句写法示例 var builder = WebApplication.CreateBuilder(args); builder.Services.AddAutoMapper(config => { // 编写映射规则,和旧版本的配置写法完全一致 config.CreateMap<AccountViewModel, Account>(); }, typeof(Program).Assembly); - 第二步:实现静态实例访问器,对接DI容器
为了让静态扩展方法可以获取到容器中初始化好的IMapper实例,编写无业务侵入的静态访问类,在应用启动完成后从构建好的DI容器中解析单例IMapper并缓存:
在应用主机构建完成后立刻完成访问器初始化,不要等到业务逻辑运行时再初始化:public static class MapperAccessor { private static IMapper? _mapper; public static void Initialize(IServiceProvider serviceProvider) { // 从DI容器中解析单例IMapper,避免重复初始化 _mapper = serviceProvider.GetRequiredService<IMapper>(); } public static IMapper Current => _mapper ?? throw new InvalidOperationException("AutoMapper未完成初始化,请在应用启动阶段调用MapperAccessor.Initialize"); }var app = builder.Build(); // 初始化静态访问器 MapperAccessor.Initialize(app.Services); // 后续注册中间件、路由等原有逻辑 app.Run(); - 第三步:改写原有扩展方法,保持方法签名不变
基于上面的静态访问器,改写旧版的扩展方法,不需要改变任何方法签名:public static Account GetAccountDomain(this AccountViewModel viewModel) { return MapperAccessor.Current.Map<AccountViewModel, Account>(viewModel); }
实现效果
完成上面的配置后,业务代码里的原有调用方式完全不需要修改,和旧版本的使用体验100%对齐:
// 原有业务调用代码无任何改动即可正常运行 accountViewModel.GetAccountDomain();
补充说明
- 该方案属于历史代码迁移的兼容实现,全新开发的业务逻辑仍推荐通过构造函数注入IMapper实例使用,减少不必要的静态依赖
- 从DI容器解析的IMapper为AutoMapper官方维护的单例实例,和直接注入使用的实例配置完全一致,不存在线程安全问题
- 所有映射规则依然可以按照官方推荐的Profile编写方式组织,不会因为兼容静态调用打乱原有代码结构
内容的提问来源于stack exchange,提问作者bahar.alirezaei
相关产品推荐
相关产品推荐

