C#/.NET中使用AutoMapper转换实体与DTO时遇映射缺失错误

针对你遇到的全局映射报错问题，以下是几个核心排查方向和解决方法：

1. Profile类未被AutoMapper正确扫描 #

• 确认你的Profile实现类是public修饰的，AutoMapper只会加载公共的Profile类型。
• 检查AddAutoMapper的参数是否指定了Profile所在的程序集。如果Profile在独立类库中，必须显式传入程序集信息，否则AutoMapper无法自动发现：

  // 替换成你的Profile类类型
  services.AddAutoMapper(typeof(UserProfile).Assembly);
  

• 务必通过依赖注入获取IMapper实例，禁止手动创建MapperConfiguration和Mapper对象，否则容器中的实例不会包含你的映射配置。

2. 嵌套类型的映射配置缺失 #

你的User和UserDTO包含嵌套对象Details和DetailsDTO，AutoMapper不会自动处理这类嵌套映射：

• 首先为嵌套类型添加基础映射：

  CreateMap<Details, DetailsDTO>();
  CreateMap<DetailsDTO, Details>();
  

• 由于DTO中的属性名是DetailsDTO，实体中是Details，属性名不匹配，需要显式指定映射关系：

  CreateMap<UserDTO, User>()
      .ForMember(dest => dest.Details, opt => opt.MapFrom(src => src.DetailsDTO));
  
  CreateMap<User, UserDTO>()
      .ForMember(dest => dest.DetailsDTO, opt => opt.MapFrom(src => src.Details));
  

3. NuGet包版本不兼容 #

• 检查AutoMapper和AutoMapper.Extensions.Microsoft.DependencyInjection的版本是否匹配，不同.NET版本对应不同的AutoMapper兼容版本（比如.NET 6+推荐使用12.x及以上版本）。
• 尝试卸载并重新安装包以解决版本冲突：

  Uninstall-Package AutoMapper
  Uninstall-Package AutoMapper.Extensions.Microsoft.DependencyInjection
  Install-Package AutoMapper.Extensions.Microsoft.DependencyInjection
  

4. 配置顺序错误 #

• 确保services.AddAutoMapper()的注册语句在业务服务注册之前执行，否则注入IMapper时，映射配置还未加载完成。
• 对于.NET 6+的Top-level语句，配置顺序示例：

  var builder = WebApplication.CreateBuilder(args);
  
  // 先注册AutoMapper
  builder.Services.AddAutoMapper(typeof(UserProfile).Assembly);
  
  // 再注册业务服务等其他依赖
  builder.Services.AddScoped<IUserService, UserService>();
  
  var app = builder.Build();
  

5. 启用映射验证提前发现问题 #

在程序启动时添加映射配置验证，能在启动阶段就暴露所有配置问题，避免运行时报错：

var app = builder.Build();

using var scope = app.Services.CreateScope();
var mapper = scope.ServiceProvider.GetRequiredService<IMapper>();
// 验证所有映射配置是否完整
mapper.ConfigurationProvider.AssertConfigurationIsValid();

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