AutoMapper无法将Org映射至CreateOrganizationRequest的Organization内部属性

核心失效原因 #

AutoMapper 默认的映射逻辑很直白：找源类和目标类上名字一样、类型一样的公开属性，把值从源拷贝到目标，它不会自作主张把整个源对象往目标类的嵌套属性里塞。你现在的映射失效本质是两个问题叠在了一起：

• 你在配置里写的目标类型是CreateRequest，但实际业务里的类是CreateOrganizationRequest，俩名字对不上，AutoMapper 根本没注册你预期的那条映射规则
• 就算你把类名改对了，这俩类也根本没有名字对得上的属性：源Org上的属性是Name、Description，但CreateOrganizationRequest上压根没有这俩属性，只有一个叫Organization的嵌套属性，类型刚好是Org，AutoMapper 自然找不到地方放值，最后映射出来的实例肯定是空的。

可直接落地的解决方案 #

按日常开发的使用频率排序，有三种方式能解决这个问题：

• 最贴合当前场景的显式配置
  直接告诉AutoMapper映射规则：把传进来的源Org实例，整个塞到目标类的Organization属性里就行，别费劲逐字段匹配了：

  // 先把之前写错的类名改对，注册正确的映射关系
  CreateMap<Org, CreateOrganizationRequest>()
      .ForMember(dest => dest.Organization, opt => opt.MapFrom(src => src));
  

  这种写法没有任何隐式规则，逻辑完全透明，后续别人看代码一眼就知道映射逻辑是啥，不会踩坑。

• 稳定性最高的构造方法配置
  如果你的业务逻辑本来就是「CreateOrganizationRequest就是给单个Org做个包装，方便接口传参」，那直接在AutoMapper构造目标实例的时候就把值赋上，比逐字段匹配靠谱多了：

  CreateMap<Org, CreateOrganizationRequest>()
      .ConstructUsing(src => new CreateOrganizationRequest
      {
          Organization = src
      });
  

  这种方式完全绕开了AutoMapper的逐字段匹配逻辑，就算以后CreateOrganizationRequest再加别的属性，只要构造逻辑不变，映射就不会失效。

• 适合复杂嵌套的批量规则配置
  如果后面CreateOrganizationRequest会加一堆和Org同类型的嵌套属性，每个都写ForMember太麻烦，可以配置匹配规则，让AutoMapper自动把源对象映射到目标类里同类型的属性上：

  // 配置匹配规则：只要属性类型和源类型一致，就自动把源值映射过去
  CreateMap<Org, CreateOrganizationRequest>()
      .ForAllMembers(opt => opt.When((src, dest, member) => member is Org));
  

  注意：这种方式有隐式匹配的风险，简单场景不推荐用，不然哪天目标类加了个同类型的属性，AutoMapper就会自动把值塞过去，很容易出隐藏bug。

避坑小提示 #

映射配置写完别着急上线，记得在项目启动的时候跑一遍AutoMapper自带的配置校验，提前发现配错的规则：

// 校验所有已注册的映射是否存在漏配、错配的问题
mapper.ConfigurationProvider.AssertConfigurationIsValid();

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