AutoMapper结合gRPC时ConvertUsing处理可空字符串映射异常问题

这不是AutoMapper的匹配bug，本质是C#可空引用类型的特性限制：string?不是独立的CLR类型，只是编译期的元数据标注，运行时string和string?完全是同一个类型。你注册的两份CreateMap<string?, string>和CreateMap<string, string?>，在运行时看就是两份完全相同的string -> string类型映射，后注册的规则会直接覆盖先注册的，所以调整注册顺序会得到完全相反的结果。

不要直接注册string类型的双向映射，改用属性级别的全局规则，通过反射识别属性上的可空编译期特性做定向转换，不会出现规则覆盖问题，一次配置全局生效。
最通用的实现是用ForAllPropertyMaps过滤所有属性映射规则，针对不同的目标属性可空性应用转换逻辑：

IMapper mapper = new MapperConfiguration(cfg =>
{
    // 规则1：目标属性为非空string时，null值自动替换为空字符串，适配gRPC DTO的非空约束
    cfg.ForAllPropertyMaps(
        predicate: pm => pm.DestinationType == typeof(string) 
                        && !pm.DestinationMember.GetCustomAttributes(true).Any(attr => attr is System.Runtime.CompilerServices.NullableAttribute),
        (_, memberCfg) => memberCfg.NullSubstitute(string.Empty)
    );

    // 规则2：目标属性为可空string时，空/纯空白字符串自动转为null
    cfg.ForAllPropertyMaps(
        predicate: pm => pm.DestinationType == typeof(string) 
                        && pm.SourceType == typeof(string)
                        && pm.DestinationMember.GetCustomAttributes(true).Any(attr => attr is System.Runtime.CompilerServices.NullableAttribute),
        (_, memberCfg) => memberCfg.AddTransform<string?>(src => string.IsNullOrWhiteSpace(src) ? null : src)
    );

    // 正常注册双向映射即可，无需单独为每个映射加转换
    cfg.CreateMap<Entity, Dto>();
    cfg.CreateMap<Dto, Entity>();
}).CreateMapper();

这里用到的NullableAttribute是编译器自动给可空引用类型成员加的编译期特性，不需要额外引入依赖，是目前运行时区分string和string?属性最可靠的标识。
如果你用AutoMapper 11及以上版本，还可以用更简洁的全局转换API实现相同效果：

// 全局注册非空string的null替换规则
cfg.AddGlobalTransform<string?>(src => src ?? string.Empty, opt =>
{
    opt.Where(pm => pm.DestinationType == typeof(string) 
                    && !pm.DestinationMember.GetCustomAttributes(true).Any(attr => attr is System.Runtime.CompilerServices.NullableAttribute));
});

大部分开发者处理protobuf生成类的适配时，通常会遵循这几个方案：

• 优先从约定层解决问题：protobuf本身的规范就是string类型无null，默认值为空字符串，很多团队会直接约定业务实体层的字符串属性也不使用null，统一用空字符串表示空值，从根源上消除适配成本，完全不用写额外转换规则。
• 如果业务层必须保留null语义，会单独抽离一个gRPC专用的AutoMapper Profile，通过命名空间/生成类标记识别所有gRPC DTO类型，统一给这类类型的所有string属性应用null转空字符串的规则，不会影响其他层之间的映射逻辑。
• 避免直接注册string -> string的全局类型转换器：这类规则会作用于所有字符串映射场景，很容易出现非预期的转换结果，属性级别的定向过滤安全性高很多，不会干扰不需要转换的映射逻辑。

你目前用的单映射加AddTransform的方案能正常工作，但维护成本高，新增映射时很容易漏加配置导致运行时抛异常（protobuf生成的属性set器传入null时会直接抛出参数空异常），用上面的全局配置可以完全避免这个问题。

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