C# AutoMapper：如何通过动态属性名实现DTO到领域实体映射？

嘿，针对你这种大部分字段名称完全匹配、仅单个关键字段不同的批量映射场景，完全不用纠结旧版本的自定义解析器——AutoMapper本身就有简洁高效的方案，完美适配你现在20多组、还会增长的映射需求。下面给你两个实用方案，按需选就行：

方案一：通用扩展方法+Profile（直观易维护） #

先封装一个扩展方法，把“配置单个差异字段+自动匹配其他字段”的逻辑抽出来，这样每一组映射只需要一行代码就能搞定，非常清晰：

public class MappingProfile : Profile
{
    public MappingProfile()
    {
        // 示例：UserDTO → User，DTO的UserId对应实体的Id
        CreateMap<UserDTO, User>()
            .MapSingleDifferentField(dto => dto.UserId, entity => entity.Id);
        
        // 其他映射组直接抄格式改字段就行
        CreateMap<OrderDTO, Order>()
            .MapSingleDifferentField(dto => dto.OrderNumber, entity => entity.Id);
        
        // 新增映射？再来一行就搞定
    }
}

// 把重复逻辑封装成扩展方法，一次写好终身复用
public static class AutoMapperExtensions
{
    public static IMappingExpression<TSource, TDestination> MapSingleDifferentField<TSource, TDestination, TField>(
        this IMappingExpression<TSource, TDestination> expression,
        Expression<Func<TSource, TField>> sourceMember,
        Expression<Func<TDestination, TField>> destMember)
    {
        // 先让AutoMapper自动匹配所有字段名一致的属性
        expression.ForAllMembers(opt => opt.Condition((src, dest, srcMember) => srcMember != null));
        // 单独指定那个不一样的关键字段
        return expression.ForMember(destMember, opt => opt.MapFrom(sourceMember));
    }
}

这个方案的好处是每一组映射的差异点一目了然，新人接手也能快速看懂，新增映射成本极低，完全不用改核心逻辑。

方案二：自定义属性+批量扫描（适合大量映射场景） #

如果未来映射组数会疯长，不想手动逐个写CreateMap，可以搞个自定义属性标记差异字段，让AutoMapper自动扫描配置，一劳永逸：

第一步，先定义个标记用的属性：

[AttributeUsage(AttributeTargets.Property, AllowMultiple = false)]
public class MapToAttribute : Attribute
{
    public string TargetPropertyName { get; }

    public MapToAttribute(string targetPropertyName)
    {
        TargetPropertyName = targetPropertyName;
    }
}

第二步，在DTO的关键字段上打标记：

public class UserDTO
{
    [MapTo("Id")] // 告诉AutoMapper：我要映射到实体的Id属性
    public Guid UserId { get; set; }
    
    // 其他字段和实体字段名完全一致，不用管
    public string Username { get; set; }
    public string Email { get; set; }
}

public class OrderDTO
{
    [MapTo("Id")]
    public string OrderNumber { get; set; }
    
    public DateTime OrderDate { get; set; }
    public decimal TotalAmount { get; set; }
}

第三步，写个自动扫描的Profile：

public class AutoScanProfile : Profile
{
    public AutoScanProfile()
    {
        // 假设你的DTO和实体都在当前程序集里，根据实际情况调整
        var currentAssembly = Assembly.GetExecutingAssembly();
        
        // 找出所有后缀是DTO的类（你可以换成自己的命名规则，比如前缀Dto）
        var dtoTypes = currentAssembly.GetTypes()
            .Where(t => t.Name.EndsWith("DTO") && !t.IsAbstract);
        
        foreach (var dtoType in dtoTypes)
        {
            // 对应实体的类型：去掉DTO后缀，比如UserDTO → User
            var entityTypeName = dtoType.Name.Replace("DTO", "");
            // 替换成你的实体所在的命名空间
            var entityType = currentAssembly.GetType($"YourProject.Domain.{entityTypeName}");
            
            if (entityType == null) continue;
            
            // 创建基础映射关系
            var mapExpr = CreateMap(dtoType, entityType);
            
            // 找出DTO里打了MapTo标记的属性
            var mappedProps = dtoType.GetProperties()
                .Where(p => p.GetCustomAttribute<MapToAttribute>() != null);
            
            foreach (var prop in mappedProps)
            {
                var attr = prop.GetCustomAttribute<MapToAttribute>();
                // 配置差异字段的映射
                mapExpr.ForMember(attr.TargetPropertyName, opt => opt.MapFrom(prop.Name));
            }
            
            // 自动匹配其他字段名一致的属性
            mapExpr.ForAllMembers(opt => opt.Condition((src, dest, srcMember) => srcMember != null));
        }
    }
}

这个方案的优势是完全自动化，新增DTO和实体时，只需要在差异字段上打个[MapTo]标记，根本不用碰Profile代码，适合映射组数特别多的场景。

小提醒 #

1. 确保用的是AutoMapper最新稳定版（至少9.0以上），旧版本的部分语法可能不兼容；
2. 如果关键字段类型不一样，可以在扩展方法或属性逻辑里加个类型转换，比如用ConvertUsing；
3. 可以开启AutoMapper的映射验证（ValidateInlineMaps = true），避免不小心漏配字段。

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