Automapper添加Profile后映射失败问题排查

这个问题我之前也碰到过，核心原因是Automapper在处理接口映射时，当存在未指定具体实现类的接口映射配置时，会默认生成动态代理实例，而这个行为会影响所有接口映射的逻辑，包括你原本正常的IModel到ModelPoco的映射。

问题分析 #

你原本的映射是数据库实体 → 实现IModel的ModelPoco，这个时候Automapper明确知道要创建ModelPoco的实例。但当你添加了RepositoryLayerProfile里的SomeOtherEntity→ISomeOtherModelInterface映射后，如果这个映射没有指定具体的实现类，Automapper会启用动态代理来生成ISomeOtherModelInterface的实例，同时这个配置会“污染”全局的接口映射逻辑，导致原本的IModel映射也被自动切换为生成Proxy<IModel>代理对象，而非ModelPoco实例，自然就出现了类型转换失败的错误。

解决方案 #

只需要给所有涉及接口的映射显式指定具体的实现类，就能让Automapper明确知道每个接口对应的具体实例类型，避免动态代理的生成：

1. 修改你原本的Profile，显式指定IModel对应的具体实现：

public class YourOriginalProfile : Profile
{
    public YourOriginalProfile()
    {
        // 关键：用.As<ModelPoco>()指定接口映射的具体实现类
        CreateMap<YourDbEntity, IModel>().As<ModelPoco>();
        
        // 如果有反向映射需求，也需要同样指定
        // CreateMap<IModel, YourDbEntity>().As<ModelPoco>();
    }
}

2. 同时修改新增的RepositoryLayerProfile，给ISomeOtherModelInterface映射也指定具体实现：

public class RepositoryLayerProfile : Profile
{
    public RepositoryLayerProfile()
    {
        // 同样指定接口对应的具体POCO类
        CreateMap<SomeOtherEntity, ISomeOtherModelInterface>().As<SomeOtherModelPoco>();
    }
}

3. （可选）启动时验证映射配置
   在应用启动阶段，调用以下代码检查所有映射配置是否有效，提前发现潜在问题：

var mapper = container.Resolve<IMapper>();
mapper.ConfigurationProvider.AssertConfigurationIsValid();

为什么这样有效？ #

Automapper 6.2.2版本中，当接口映射没有显式指定具体实现类时，会默认使用动态代理来创建接口实例。当你添加了第二个无指定的接口映射后，全局的映射逻辑被触发了代理生成规则，影响了原有映射。通过As<>方法明确指定每个接口对应的具体类型，Automapper就会直接创建指定的POCO实例，而不会生成代理对象，类型转换自然就正常了。

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