解决 ASP.NET Core AutoMapper 的 CS0121 歧义错误

问题描述

在 ASP.NET Core 6 项目中使用 AutoMapper 时，开发者可能遇到以下编译错误：

Error CS0121
The call is ambiguous between the following methods or properties: 
'Microsoft.Extensions.DependencyInjection.ServiceCollectionExtensions.AddAutoMapper(...)' 
and 'Microsoft.Extensions.DependencyInjection.ServiceCollectionExtensions.AddAutoMapper(...)'

此错误通常发生在以下场景：

• 更新了 AutoMapper.Extensions.Microsoft.DependencyInjection 包至 v12.0.1
• 在注册 AutoMapper 时使用 services.AddAutoMapper(typeof(AuthMapperProfile))
• 项目文件引用了 AutoMapper 的 DI 包

典型错误代码位置：

// AutoMapperServiceExtension.cs
public static void ConfigureAutoMappers(this IServiceCollection services)
{
    services.AddAutoMapper(typeof(AuthMapperProfile)); // 此处报错
}

根本原因与当前最新的 AutoMapper v13+ 版本架构变更有关。

解决方案

✅ 方法一：升级 AutoMapper 并移除 DI 包（推荐）

根本性修复

AutoMapper v13 不再需要额外的依赖注入包，核心功能已集成主库

1. 升级 AutoMapper 核心包 (版本 ≥13.0.0)
2. 移除 AutoMapper.Extensions.Microsoft.DependencyInjection 包
3. 保留原有的 AddAutoMapper() 调用方式

操作步骤：

1. 修改项目文件 (.csproj)

<ItemGroup>
-    <PackageReference Include="AutoMapper.Extensions.Microsoft.DependencyInjection" Version="12.0.0" />
+    <PackageReference Include="AutoMapper" Version="13.0.1" />
</ItemGroup>

2. 确保 Program.cs 保持原有注册方式

// Program.cs
builder.Services.ConfigureAutoMappers(); // 内部调用 AddAutoMapper

3. 确保映射配置类继承 Profile

// 如 AuthMapperProfile.cs
public class AuthMapperProfile : Profile
{
    public AuthMapperProfile()
    {
        CreateMap<ApplicationUser, UserDto>().ReverseMap();
        // 其他映射配置...
    }
}

✅ 方法二：明确指定程序集标记类型

如果项目需要保留较低版本 AutoMapper (v12)，可改用完整程序集注册：

// 修改 AutoMapperServiceExtension.cs
public static void ConfigureAutoMappers(this IServiceCollection services)
{
    // 使用 typeof(Program) 作为程序集标记
    services.AddAutoMapper(typeof(Program).Assembly);
}

注意

此方法属于临时解决方案，推荐升级到 v13+ 以获得长期支持

原理分析

错误产生原因

因素	说明
包冲突	AutoMapper v13 将 DI 功能移至核心包，旧 DI 包与之冲突
方法签名重叠	核心包与 DI 包存在同名的 AddAutoMapper 方法
编译器歧义	无法确定调用哪个程序集的方法实现

方案对比

方案	维护性	兼容性	推荐指数
升级核心包 + 移除 DI 包	⭐⭐⭐⭐	.NET 6+	⭐⭐⭐⭐⭐
指定程序集注册	⭐⭐	兼容旧版本	⭐⭐

最佳实践

在 Program.cs 中直接注册 AutoMapper 更简洁：

// Program.cs
builder.Services.AddAutoMapper(typeof(AuthMapperProfile));

这样可避免额外的扩展方法封装

注意事项

1. 依赖项清理：移除 DI 包后，确保卸载所有残留文件
2. 版本检查：升级后验证所有相关包版本一致性

   dotnet list package

3. 迁移指南：完整升级步骤参考 AutoMapper v13 官方迁移文档

总结

当遇到 AddAutoMapper 的 CS0121 歧义错误时，本质原因是 AutoMapper v13 的架构变更。移除 AutoMapper.Extensions.Microsoft.DependencyInjection 包并升级 AutoMapper 到最新版本是最彻底的解决方案。此操作：

1. 消除程序集冲突
2. 保持原有接口不变
3. 确保项目依赖符合现代包管理规范
4. 避免未来可能的兼容性问题

升级完成后，原有的映射配置和注册代码无需修改即可正常工作。