You need to enable JavaScript to run this app. 如何在.NET Core环境下通过扩展方法使用AutoMapper 10?
优惠活动
大模型
产品
解决方案
定价
更多

如何在.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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 07:36:02