AutoMapper中MapFrom引发的NullReferenceException问题解析

问题现象

在使用AutoMapper进行对象映射时，当源对象的属性为null时，如果在MapFrom配置中使用了Convert.ToString等转换方法，调试模式下会观察到System.NullReferenceException异常，尽管最终映射结果正确。

问题复现

考虑以下场景：我们有一个包含嵌套对象的源类型Foo，其中Bar属性可能为null。目标类型Destination有一个字符串类型的Value属性。我们希望通过AutoMapper将Foo映射到Destination，当Bar为null时不进行映射。

class Foo
{
    public Bar? Bar;
}

class Bar
{
    public uint Value;
}

class Destination
{
    public string? Value;
}

配置映射时，我们使用ForMember和MapFrom：

cfg.CreateMap<Foo, Destination>()
    .ForMember(dest => dest.Value, opt => 
    {
        opt.Condition(opt => opt.Bar != null);
        opt.MapFrom(foo => Convert.ToString(foo.Bar.Value));
    });

问题本质

这个问题的核心在于AutoMapper的条件检查(MapFrom中的Condition)和值转换(Convert.ToString)的执行顺序。虽然我们添加了Condition来防止null引用，但在调试模式下仍能看到NullReferenceException，这是因为：

1. AutoMapper会先尝试执行MapFrom中的表达式
2. 然后才会应用Condition条件检查
3. 当foo.Bar为null时，访问foo.Bar.Value自然会抛出异常

解决方案

方案1：简化映射配置

如果只是简单的类型转换，可以依赖AutoMapper的内置null检查机制：

cfg.CreateMap<Foo, Destination>()
    .ForMember(dest => dest.Value, opt => opt.MapFrom(foo => foo.Bar.Value));

AutoMapper会自动处理null情况，无需显式添加Condition。

方案2：使用扁平化映射

利用AutoMapper的扁平化命名约定：

cfg.CreateMap<Foo, Destination>();

这样AutoMapper会自动匹配"Bar.Value"到"Value"的映射，并处理null情况。

方案3：使用自定义值解析器

对于复杂的null检查场景，可以使用IValueResolver：

public class BarValueResolver : IValueResolver<Foo, Destination, string>
{
    public string Resolve(Foo source, Destination destination, string destMember, ResolutionContext context)
    {
        return source.Bar == null ? null : Convert.ToString(source.Bar.Value);
    }
}

// 配置
cfg.CreateMap<Foo, Destination>()
    .ForMember(dest => dest.Value, opt => opt.MapFrom<BarValueResolver>());

最佳实践建议

1. 尽量使用AutoMapper的内置null检查机制，避免不必要的Condition配置
2. 对于简单的属性映射，优先考虑扁平化配置
3. 复杂的null检查和转换逻辑应该封装在自定义值解析器中
4. 在调试时，如果看到内部异常但最终结果正确，可以检查是否是Condition和MapFrom执行顺序导致的问题

总结

AutoMapper的MapFrom和Condition配置需要理解其执行顺序。虽然本例中最终结果正确，但调试时出现的异常可能会干扰开发。通过简化配置或使用自定义解析器，可以避免这类问题，同时保持代码的清晰和可维护性。理解AutoMapper的内部工作机制有助于编写更健壮的映射配置。