使用AutoMapper值转换器隐藏数据库主键ID时转换器未生效问题

自定义转换器不生效是三个典型问题导致的：

• 仅配置了非空Id字段的转换规则，没有覆盖ParentCategoryId这类可空ID字段。AutoMapper对int/int?、string/string?是按不同类型做匹配的，你写的非空类型转换器不会自动应用到可空字段上，这类字段会直接走内置的简单类型转换，把int直接ToString成数字字符串。
• 如果使用ProjectTo()对接EF Core做查询投影，普通IValueConverter如果不支持表达式树翻译，AutoMapper会直接回退到默认转换逻辑，根本不会执行你写的Hashids编解码代码。
• 依赖ReverseMap()自动继承正向映射的转换器配置是无效的，反向映射的类型转换规则需要单独生效，加上低版本AutoMapper对record类型的init属性识别有偏差，很容易出现配置不生效的问题。

1. 优化转换器实现 #

首先不要每次转换都新建Hashids实例，全局复用单例避免性能损耗和参数不一致问题，同时补充可空类型的转换器：

// 全局复用Hashids实例，盐值、哈希长度按需自定义
public static class HashidsGlobal
{
    public static readonly Hashids Instance = new Hashids("your_custom_salt", 8);
}

public class HideIdConverter : IValueConverter<int, string>
{
    public string Convert(int sourceMember, ResolutionContext context)
        => HashidsGlobal.Instance.Encode(sourceMember);
}

public class HideNullableIdConverter : IValueConverter<int?, string?>
{
    public string? Convert(int? sourceMember, ResolutionContext context)
        => sourceMember.HasValue ? HashidsGlobal.Instance.Encode(sourceMember.Value) : null;
}

public class UnhideIdConverter : IValueConverter<string, int>
{
    public int Convert(string sourceMember, ResolutionContext context)
    {
        if (string.IsNullOrWhiteSpace(sourceMember)) return default;
        var decodeRes = HashidsGlobal.Instance.Decode(sourceMember);
        return decodeRes.Length > 0 ? decodeRes[0] : default;
    }
}

public class UnhideNullableIdConverter : IValueConverter<string?, int?>
{
    public int? Convert(string? sourceMember, ResolutionContext context)
    {
        if (string.IsNullOrWhiteSpace(sourceMember)) return null;
        var decodeRes = HashidsGlobal.Instance.Decode(sourceMember);
        return decodeRes.Length > 0 ? decodeRes[0] : null;
    }
}

2. 配置全局类型转换规则 #

不要给每个实体的ID字段单独写ForMember配置，直接在AutoMapper配置里加全局的类型映射规则，所有实体/DTO里匹配类型的字段会自动套用转换逻辑，不需要重复配置，也不会漏掉可空字段：

var mapperConfig = new MapperConfiguration(cfg =>
{
    // 全局注册ID类型双向转换规则
    cfg.CreateMap<int, string>().ConvertUsing<HideIdConverter>();
    cfg.CreateMap<int?, string?>().ConvertUsing<HideNullableIdConverter>();
    cfg.CreateMap<string, int>().ConvertUsing<UnhideIdConverter>();
    cfg.CreateMap<string?, int?>().ConvertUsing<UnhideNullableIdConverter>();

    // 实体和DTO映射不需要单独配置ID字段，全局规则自动生效
    cfg.CreateMap<Dal.Entities.Category, Category>().ReverseMap();
});

注意：如果要在EF Core的ProjectTo()投影中使用这套逻辑，需要确认你使用的Hashids版本支持表达式树翻译，否则会出现SQL翻译失败的问题，这种场景建议先查询数据到内存后再执行映射。

3. 兼容性处理 #

• 把AutoMapper升级到11.0以上版本，低版本对record类型init属性的映射存在已知bug。
• 不要在转换器里写依赖外部作用域的逻辑，否则投影场景下会执行失败。

初始化mapper后直接做双向映射测试即可：

var mapper = mapperConfig.CreateMapper();

// 实体转DTO测试
var dalEntity = new Dal.Entities.Category("生鲜分类") { Id = 1, ParentCategoryId = 3 };
var dto = mapper.Map<Category>(dalEntity);
// 此时dto.Id、dto.ParentCategoryId均为Hashids生成的哈希字符串，不会出现"1""3"这类纯数字字符串

// DTO转实体测试
var submitDto = new Category("生鲜分类") { Id = "对应Id的哈希值", ParentCategoryId = "对应父Id的哈希值" };
var entity = mapper.Map<Dal.Entities.Category>(submitDto);
// 此时entity.Id、entity.ParentCategoryId均为解析后的整型数值

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