Dapper.NET 对全平台 IAsyncEnumerable 支持的技术解析

背景介绍

Dapper.NET 作为一款轻量级ORM工具，在.NET生态系统中广受欢迎。近期社区提出了一个重要需求：希望Dapper能够在所有支持的.NET平台上实现IAsyncEnumerable接口支持，而不仅限于.NET 5及以上版本。

现状分析

当前Dapper代码库中，IAsyncEnumerable支持被限制在.NET 5或更高版本中实现。这主要是因为IAsyncEnumerable接口最初是在.NET Core 3.0/.NET Standard 2.1中引入的。对于较早的.NET Framework版本(如.NET 4.6.2)和.NET Standard 2.0目标框架，开发者无法使用QueryUnbufferedAsync等返回IAsyncEnumerable的方法。

技术解决方案

实际上，微软提供了一个向后兼容的解决方案——Microsoft.Bcl.AsyncInterfaces NuGet包。这个经过良好维护的BCL(基础类库)包能够为旧版框架添加IAsyncEnumerable接口支持。该方案已被许多流行库广泛采用，用于在旧平台上实现异步流功能。

实现这一改进只需要：

1. 为netstandard2.0和net462目标添加对Microsoft.Bcl.AsyncInterfaces包的依赖
2. 移除现有代码中对.NET 5+版本的平台限制条件
3. 确保异步流功能在所有目标平台上表现一致

技术影响评估

这一改进将为仍在使用旧版.NET Framework的开发者带来显著价值：

• 允许在.NET 4.7.2等旧平台上使用更高效的异步流API
• 避免被迫使用Task<IEnumerable>等替代方案带来的性能开销
• 提供更一致的API体验，减少平台差异带来的代码分支

升级建议

虽然这一改进能为旧平台带来好处，但长期来看，迁移到现代.NET版本(.NET 6+)仍然是推荐做法。现代.NET平台提供了：

• 更好的性能优化
• 更长的技术支持周期
• 更丰富的API生态系统
• 更先进的运行时特性

对于大型遗留系统，可以采取渐进式迁移策略，先通过此类兼容性改进获得部分新特性，再逐步完成全面升级。

实现状态

该功能已在Dapper 2.1.66版本中实现，开发者现在可以在所有支持的平台上使用IAsyncEnumerable相关API。