Mapperly映射工具中嵌套对象初始化问题的分析与解决

问题背景

在.NET生态系统中，对象映射是一个常见需求，Mapperly作为一款高效的代码生成工具，能够自动生成对象映射代码。近期发现Mapperly在特定场景下生成的映射代码存在缺陷，可能导致运行时NullReferenceException异常。

问题现象

当使用Mapperly进行对象映射时，如果满足以下条件，生成的代码会出现空引用异常：

1. 启用了AllowNullPropertyAssignment = false配置
2. 多个属性映射到同一个嵌套对象
3. 第一个源属性值为null

技术分析

让我们通过一个具体案例来分析问题。假设有以下DTO和实体类：

public class Foo
{
    public decimal? Property1 { get; set; }
    public decimal? Property2 { get; set; }
}

public class FooDto
{
    public BarDto? BarDto { get; set; }
}

public class BarDto
{
    public double PropertyA { get; set; }
    public double PropertyB { get; set; }
}

Mapperly生成的映射代码如下：

public static FooDto ToDto(this Foo foo)
{
    var target = new FooDto();
    if (foo.Property1 != null)
    {
        target.BarDto ??= new BarDto();
        target.BarDto.PropertyA = MapToDouble(foo.Property1.Value);
    }
    if (foo.Property2 != null)
    {
        target.BarDto.PropertyB = MapToDouble(foo.Property2.Value);
    }
    return target;
}

问题根源

问题出在条件逻辑的处理上。当Property1为null时，代码会跳过第一个if块，直接进入第二个if块处理Property2。此时target.BarDto尚未初始化，导致访问PropertyB时抛出NullReferenceException。

解决方案

正确的代码生成应该确保在任何情况下访问嵌套对象属性前都先初始化对象。修正后的代码应为：

public static FooDto ToDto(this Foo foo)
{
    var target = new FooDto();
    if (foo.Property1 != null)
    {
        target.BarDto ??= new BarDto();
        target.BarDto.PropertyA = MapToDouble(foo.Property1.Value);
    }
    if (foo.Property2 != null)
    {
        target.BarDto ??= new BarDto();
        target.BarDto.PropertyB = MapToDouble(foo.Property2.Value);
    }
    return target;
}

技术影响

这个问题在Mapperly 4.1.1版本中引入，在3.6.0版本中不存在。它影响了以下环境：

• .NET 8.0及以上版本
• 启用了nullable reference types的项目
• 使用嵌套对象映射的场景

最佳实践建议

为避免类似问题，开发者可以采取以下措施：

1. 对于可能为null的嵌套对象，在映射前手动初始化
2. 考虑使用更简单的扁平化DTO结构
3. 在复杂映射场景中增加单元测试覆盖所有边界条件
4. 暂时回退到3.6.0版本等待修复

总结

对象映射工具在提高开发效率的同时，也需要开发者理解其内部工作机制。这次Mapperly的问题提醒我们，即使是自动生成的代码，也需要进行充分的测试，特别是边界条件的测试。对于嵌套对象的映射，确保对象初始化是避免空引用异常的关键。