AutoMapper映射到init-only属性时丢失HashSet自定义比较器

问题背景 #

在使用AutoMapper映射包含IReadOnlySet<string>属性的目标模型时，即使在MapFrom中生成了带有StringComparer.OrdinalIgnoreCase的HashSet，AutoMapper也会内部重建集合，导致自定义比较器丢失，最终无法实现大小写不敏感的集合查询。

解决方案 #

以下几种方法可以阻止AutoMapper重建集合，保留自定义比较器：

方法1：通过AfterMap手动赋值 #

忽略目标属性的自动映射逻辑，在映射完成后直接设置预先生成的HashSet：

var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<DtoWithCollection, ReadOnlySetTestModel>()
       .ForMember(dest => dest.Values, opt => opt.Ignore())
       .AfterMap((src, dest) => 
           dest.Values = src.Values
               .Distinct(StringComparer.OrdinalIgnoreCase)
               .ToHashSet(StringComparer.OrdinalIgnoreCase)
       );
});

方法2：配置HashSet到IReadOnlySet的直接转换 #

添加类型映射规则，让AutoMapper直接传递HashSet实例，不重新构建集合：

var config = new MapperConfiguration(cfg =>
{
    // 禁用AutoMapper对HashSet转IReadOnlySet的默认重建逻辑
    cfg.CreateMap<HashSet<string>, IReadOnlySet<string>>().ConvertUsing(s => s);

    cfg.CreateMap<DtoWithCollection, ReadOnlySetTestModel>()
       .ForMember(dest => dest.Values, opt => opt.MapFrom(src =>
           src.Values.Distinct(StringComparer.OrdinalIgnoreCase)
               .ToHashSet(StringComparer.OrdinalIgnoreCase)
       ));
});

方法3：全局自定义类型转换器 #

创建通用转换器，处理所有字符串集合到带IgnoreCase比较器的IReadOnlySet的转换：

public class StringCollectionToIgnoreCaseHashSetConverter : ITypeConverter<IReadOnlyCollection<string>, IReadOnlySet<string>>
{
    public IReadOnlySet<string> Convert(IReadOnlyCollection<string> source, IReadOnlySet<string> destination, ResolutionContext context)
    {
        return source.Distinct(StringComparer.OrdinalIgnoreCase)
                     .ToHashSet(StringComparer.OrdinalIgnoreCase);
    }
}

// 配置时注册转换器
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<IReadOnlyCollection<string>, IReadOnlySet<string>>()
       .ConvertUsing<StringCollectionToIgnoreCaseHashSetConverter>();

    cfg.CreateMap<DtoWithCollection, ReadOnlySetTestModel>();
});

原因解析 #

AutoMapper默认会将集合视为IEnumerable<T>，遍历元素并创建新的目标集合实例（使用默认比较器）。即使在MapFrom中返回了带有自定义比较器的HashSet，它也会忽略原实例的比较器，重新构建集合，导致自定义逻辑丢失。上述方法均通过绕过或修改AutoMapper的默认集合处理逻辑，直接使用预先生成的带自定义比较器的HashSet。

内容的提问来源于stack exchange，提问作者Vojtěch Večeřa