ASP.NET Automapper映射时无法向PersonalChatDto的Avatars列表添加元素

问题根源 #

你遇到的核心问题有两点：

1. Record类型的不可变性特性：你的PersonalChatDto是C# record类型，通过位置参数定义的属性默认是init只读的。Automapper处理record映射时，默认会创建新的record实例，而非直接修改现有实例。
2. MapFrom的行为逻辑：你使用MapFrom返回修改后的列表，但这个操作会触发Automapper生成新的record实例，覆盖你之前从Chat映射得到的原Dto，导致原列表内容丢失，最终呈现为空。

解决方案 #

改用AfterMap替代MapFrom，直接在已有的Dto实例上修改Avatars列表，同时确保映射时使用更新现有对象的重载方法。

修改后的映射配置 #

CreateMap<Contact, PersonalChatDto>()
    .ForMember(dest => dest.Id, opt => opt.Ignore())
    .ForMember(dest => dest.FirstName, opt => opt.MapFrom(src => src.CustomFirstName))
    .ForMember(dest => dest.LastName, opt => opt.MapFrom(src => src.CustomLastName))
    .AfterMap((src, dest, context) =>
    {
        var contactAvatar = src.CustomAvatar;
        if (contactAvatar == null) return;

        // 先确保Avatars列表不为null，避免空引用异常
        dest.Avatars ??= new List<AvatarDto>();
        // 向现有列表添加新的头像Dto
        dest.Avatars.Add(context.Mapper.Map<AvatarDto>(contactAvatar));
    });

正确的映射执行方式 #

必须使用Automapper的Map重载方法，明确传入已有的Dto实例作为目标对象，确保是更新而非创建新实例：

// 第一步：从Chat映射得到初始的PersonalChatDto
var initialDto = _mapper.Map<PersonalChatDto>(chatInstance);

// 第二步：用Contact更新已有的Dto实例，追加头像
_mapper.Map(contactInstance, initialDto);

原理说明 #

• AfterMap会在基础映射完成后触发，直接操作已存在的目标Dto实例，绕过了record类型创建新实例的默认行为。
• 因为Avatars是List<AvatarDto>?类型，虽然record的属性是init只读，但我们并没有重新赋值Avatars属性，只是修改了列表内部的元素，这完全符合record的设计规则。

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