AutoMapper为何自动映射复杂实体ID？如何阻止该行为？

原因 #

AutoMapper默认开启扁平化映射规则：当源对象存在嵌套属性（比如PersonSource.Contact.Id），目标对象中存在符合命名规则的对应字段（比如PersonDestination.ContactId，即嵌套属性名+ID的组合）时，AutoMapper会自动完成映射，不需要手动配置。这是框架为简化常见DTO与实体映射（比如EF外键场景）设计的默认行为。

解决方法 #

1. 显式忽略目标字段 #

在PersonSource到PersonDestination的映射配置中，直接忽略ContactId字段：

CreateMap<PersonSource, PersonDestination>()
    .ForMember(dest => dest.ContactId, opt => opt.Ignore());

2. 全局关闭扁平化映射 #

如果你的项目不需要全局的扁平化映射功能，可以在AutoMapper初始化时关闭该特性：

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.DisableFlattening(); // 关闭默认扁平化映射
    // 其他映射配置...
});

3. 采用白名单式映射 #

只显式配置需要映射的字段，未配置的字段不会被AutoMapper自动处理：

CreateMap<PersonSource, PersonDestination>()
    .ForMember(dest => dest.Id, opt => opt.MapFrom(src => src.Id))
    .ForMember(dest => dest.Contact, opt => opt.MapFrom(src => src.Contact))
    // 不配置ContactId，AutoMapper不会自动映射该字段

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