Mapperly项目中IReadOnlyList嵌套映射问题的分析与解决

问题背景

在.NET生态系统中，Riok.Mapperly是一个高效的代码生成库，用于简化对象之间的映射操作。近期在使用Mapperly进行复杂类型映射时，开发者遇到了一个关于嵌套集合类型映射的编译错误问题。

问题现象

当使用IReadOnlyList<IReadOnlyList<X>>这样的嵌套集合类型进行映射时，Mapperly在3.4.0及以上版本生成的代码会出现编译错误。具体错误信息为：

Array creation must have array size or array initializer
Invalid rank specifier: expected ',' or ']'

问题分析

通过对比3.3.0版本和3.4.0版本的生成代码，我们可以发现关键差异：

1. 3.3.0版本生成的代码正确使用了IReadOnlyList<DestTimeValueId>[]这样的数组声明方式
2. 3.4.0及以上版本生成的代码错误地使用了DestTimeValueId[][]这样的锯齿数组语法，并且在数组大小声明上存在问题

问题的核心在于Mapperly在处理嵌套的IReadOnlyList类型时，错误地将其转换为锯齿数组的语法，而不是保持原有的IReadOnlyList数组形式。

技术细节

在C#中，数组声明有以下几种正确形式：

1. 一维数组：T[] array = new T[size]
2. 多维数组：T[,] array = new T[size1, size2]
3. 锯齿数组：T[][] array = new T[size][]

而Mapperly 3.4.0生成的代码var target = new global::MapperlyBug.DestTimeValueId[][source.Count]不符合上述任何一种合法语法，导致编译错误。

解决方案

对于这个问题的临时解决方案是降级到Mapperly 3.3.0版本，该版本生成的代码是正确的：

private global::System.Collections.Generic.IReadOnlyList<global::System.Collections.Generic.IReadOnlyList<global::MapperlyBug.DestTimeValueId>> MapToIReadOnlyList1(global::System.Collections.Generic.IReadOnlyList<global::System.Collections.Generic.IReadOnlyList<global::MapperlyBug.SrcTimeValueId>> source)
{
    var target = new global::System.Collections.Generic.IReadOnlyList<global::MapperlyBug.DestTimeValueId>[source.Count];
    // ...
}

从长远来看，开发者应该等待Mapperly团队修复这个bug。根据issue的状态，这个问题已经被关闭，可能已经在后续版本中修复。

最佳实践

在使用Mapperly进行复杂类型映射时，建议：

1. 对于嵌套集合类型，先在小规模测试中验证映射是否正确
2. 关注Mapperly的版本更新日志，了解已知问题的修复情况
3. 考虑为复杂的映射场景编写自定义映射方法，而不是完全依赖自动生成

总结

这个案例展示了在使用代码生成工具时可能遇到的边界情况。虽然工具可以大幅提高开发效率，但开发者仍需理解生成的代码逻辑，并具备调试生成代码的能力。对于Mapperly这样的工具，了解其在不同版本间的行为变化也很重要，特别是在升级版本时需要进行充分的测试验证。