如何为AutoMapper启用配置验证并在编译时检测映射错误？

方案1：利用AutoMapper内置的编译时验证 #

AutoMapper本身提供了配置验证能力，你可以通过提前初始化映射配置并强制执行验证，把映射规则的检查提前到编译/构建阶段。

具体实现：

1. 统一管理映射配置：

public static class MapperSetup
{
    public static IMapper BuildMapper()
    {
        var config = new MapperConfiguration(cfg =>
        {
            cfg.AddProfile<UserProfile>();
            cfg.AddProfile<OrderProfile>();
            // 注册所有需要的Profile
        });

        // 验证所有已注册的映射规则是否完整，包括同类型映射
        config.AssertConfigurationIsValid();
        return config.CreateMapper();
    }
}

2. 编写单元测试强制验证：

[TestClass]
public class MapperValidationTests
{
    [TestMethod]
    public void AllMapperConfigsAreValid()
    {
        // 初始化时如果存在未配置的映射，会直接抛出异常
        var mapper = MapperSetup.BuildMapper();
    }
}

把这个测试设置为CI构建的必过环节，这样在编译阶段就能捕获缺失的映射规则，而非等到运行时才暴露问题。

方案2：自定义泛型约束做编译时拦截 #

通过自定义标记接口和泛型扩展方法，让编译器直接拦截未配置映射的Map调用：

1. 定义标记接口，用于标识已配置的映射对：

public interface IMapConfigured<TSource, TDestination> { }

2. 让对应的Profile实现该接口（同类型映射就是IMapConfigured<T, T>）：

public class UserProfile : Profile, IMapConfigured<User, User>
{
    public UserProfile()
    {
        CreateMap<User, User>();
        // 其他映射规则
    }
}

3. 编写带约束的扩展方法：

public static class MapperExtensions
{
    public static TDestination Map<TSource, TDestination>(this IMapper mapper, TSource source)
        where TDestination : IMapConfigured<TSource, TDestination>
    {
        return mapper.Map<TDestination>(source);
    }
}

这种情况下，如果你调用mapper.Map<User, User>(user)但没实现对应的标记接口，编译器会直接报错。缺点是需要手动维护标记接口，适合小型项目或特定场景。

方案3：自定义Roslyn分析器（适合大型项目） #

编写Roslyn分析器，扫描代码中所有Map<TSource, TDestination>调用，自动检查AutoMapper Profile中是否存在对应映射规则，不存在则抛出编译错误。

这种方式无需修改业务代码，完全在编译阶段自动检测：

• 用Roslyn API遍历代码中的泛型Map调用，提取类型参数
• 解析项目中所有Profile类，提取CreateMap配置的类型对
• 对比两者，发现未配置的映射时直接报告编译错误

虽然实现成本稍高，但能彻底解决编译时检测的需求，适合大型项目长期维护。

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