AutoMapper 1:1映射报错：属性名一致仍检测到未映射成员

嘿，我之前也碰到过类似的坑！明明实体和ViewModel的属性看起来完全对应，AutoMapper却偏要抛出未映射成员的错误，真的挺闹心的。咱们一步步来排查可能的原因：

1. 大小写不匹配（最常见的原因！） #

AutoMapper默认是区分大小写的！比如你实体里的id（全小写），如果ViewModel里对应的属性是Id（首字母大写），在AutoMapper眼里这就是两个完全不同的属性。

举个例子，你的实体定义是：

public class Product { 
    public int id { get; set; } 
    public string sku { get; set; } 
    // ...其他属性
}

如果ViewModel里的属性是public int Id { get; set; }，那AutoMapper就会认为id没有对应的目标属性，直接报错。

解决方案：

• 要么统一双方的属性命名大小写；
• 要么全局配置命名规则，让AutoMapper自动适配大小写差异：

  var config = new MapperConfiguration(cfg =>
  {
      // 源（实体）是小写命名，目标（ViewModel）是帕斯卡命名（首字母大写）
      cfg.SourceMemberNamingConvention = new LowerCaseNamingConvention();
      cfg.DestinationMemberNamingConvention = new PascalCaseNamingConvention();
      cfg.CreateMap<Product, ProductViewModel>();
  });
  

2. 属性访问修饰符问题 #

AutoMapper默认只能访问公共可读写的属性，如果你有属性的访问权限不对，也会触发未映射错误：

• 如果是从实体映射到ViewModel：实体的属性需要有public get，ViewModel的属性需要有public set；
• 如果是从ViewModel映射到实体：ViewModel的属性需要有public get，实体的属性需要有public set。

比如如果你的实体属性是public int id { get; }（只有getter，没有setter），当你尝试把ViewModel映射到实体时，AutoMapper无法设置这个属性，就会报错。

3. 未完成/缺失的属性 #

看你给出的实体代码里有public int numberC...，看起来是没写完的属性——如果这个属性在你的ViewModel里没有对应的字段，AutoMapper会默认认为这个成员需要映射，但找不到目标，所以报错。

解决方案：

• 要么给ViewModel补上对应的属性；
• 要么手动忽略这个不需要映射的属性：

  var config = new MapperConfiguration(cfg =>
  {
      cfg.CreateMap<Product, ProductViewModel>()
         // 忽略单个未映射属性
         .ForMember(dest => dest.UnmappedProperty, opt => opt.Ignore())
         // 或者直接忽略所有其他未映射的源成员
         .ForAllOtherMembers(opt => opt.Ignore());
  });
  

4. 映射方向搞反了 #

AutoMapper的映射是单向的！如果你创建的映射是CreateMap<ProductViewModel, Product>（从ViewModel到实体），但实际你是在把实体转换成ViewModel，那如果ViewModel里有实体没有的属性，就会报错。

另外，AutoMapper的默认验证会检查源中的所有成员是否都有对应的目标成员，所以如果方向搞反，很容易触发错误。

最后一招：精准定位错误 #

如果还是找不到问题，建议在初始化Mapper的时候加上配置验证，它会告诉你具体是哪个成员未映射，直接帮你定位问题：

var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Product, ProductViewModel>();
});
// 这行代码会抛出详细的错误信息，指明未映射的成员名称
config.AssertConfigurationIsValid();
var mapper = config.CreateMapper();

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