Riok.Mapperly 在 .NET Standard 2.0 下处理 ObservableCollection 的兼容性问题

问题背景

Riok.Mapperly 是一个高效的 .NET 对象映射代码生成器，它通过编译时代码生成而非运行时反射来实现高性能的对象映射。最近发现了一个与 .NET Standard 2.0 兼容性相关的问题：当映射包含 ObservableCollection 类型的属性时，在 .NET Standard 2.0 项目中代码生成会失败，而在 .NET 8 项目中则工作正常。

问题现象

开发者在使用 Riok.Mapperly 时发现以下情况：

1. 当映射器定义在 .NET 8 类库中时，能够正确生成包含 ObservableCollection 属性的映射代码
2. 同样的映射器定义在 .NET Standard 2.0 类库中时，代码生成失败
3. 错误信息显示无法获取 System.Collections.Immutable.ImmutableArray 类型

技术分析

这个问题本质上与 .NET Standard 2.0 和 .NET Core/.NET 5+ 之间的类型系统差异有关。具体来说：

1. ObservableCollection 的依赖关系：ObservableCollection 在 .NET Standard 2.0 中的实现与较新版本的 .NET 有所不同，它可能间接依赖于某些不可变集合类型。

2. ImmutableArray 的可用性：错误信息表明代码生成器尝试访问 ImmutableArray 类型，这在 .NET Standard 2.0 环境中可能不可用或需要额外引用。

3. 编译时环境差异：代码生成器在 .NET Standard 2.0 和 .NET 8 下运行时可能访问不同的基础库版本，导致类型解析行为不同。

解决方案

Riok.Mapperly 团队已经修复了这个问题，修复内容将包含在下一个预览版本中。对于遇到此问题的开发者，可以考虑以下临时解决方案：

1. 升级目标框架：如果可能，将项目升级到 .NET Core 3.1 或更高版本，以获得更好的兼容性。

2. 手动添加引用：在 .NET Standard 2.0 项目中显式添加 System.Collections.Immutable 包引用。

3. 自定义映射：对于 ObservableCollection 属性，可以暂时使用自定义映射方法绕过自动生成。

长期建议

虽然 Riok.Mapperly 团队已经修复了这个问题，但需要注意：

1. .NET Standard 2.0 支持：项目团队表示对 .NET Standard 2.0 的支持是"尽力而为"的，没有专门的集成测试。

2. 贡献机会：团队欢迎贡献者添加针对 .NET Standard 2.0 的集成测试，以提高长期兼容性。

3. 版本选择：对于新项目，建议使用较新的 .NET 版本以获得最佳支持和性能。

总结

这个案例展示了跨平台 .NET 开发中可能遇到的类型系统兼容性问题。Riok.Mapperly 团队快速响应并修复了 ObservableCollection 在 .NET Standard 2.0 下的映射问题，同时也提醒开发者注意不同目标框架间的兼容性差异。对于必须使用 .NET Standard 2.0 的项目，可以期待即将发布的修复版本，或者考虑上述临时解决方案。