Dapper.NET 2.1.66版本发布：稳定性优化与性能提升

项目简介

Dapper.NET是一个轻量级的对象关系映射(ORM)框架，作为.NET平台上最受欢迎的数据访问组件之一，它以高性能和简洁的API著称。Dapper在ADO.NET基础上提供了扩展方法，使得数据库操作更加便捷，同时保持了接近原生ADO.NET的性能表现。

版本核心变更

2.1.66版本是一个重要的稳定性更新，主要解决了之前版本中存在的若干问题，并对性能进行了优化。这个版本特别值得注意的一点是，它正式移除了之前存在严重问题的DateOnly/TimeOnly支持功能。

重大变更说明

DateOnly/TimeOnly支持回退：在2.1.37版本中引入的DateOnly/TimeOnly类型支持被发现存在多个故障模式，开发团队迅速回滚了这一功能。2.1.66版本作为这一事件后的首个稳定版本，彻底移除了相关实现。这意味着如果应用依赖了2.1.37版本中的这一特性，升级到2.1.66后将失去这部分功能。

主要改进内容

1. 目标框架更新：

   • 新增对.NET 8 LTS版本的支持
   • 移除了对已结束支持的.NET 5和.NET 7的支持

2. 异步API统一：

   • 对所有目标框架版本(TFM)的异步API表面进行了标准化处理
   • 确保了跨不同.NET版本的行为一致性

3. 数据读取器处理优化：

   • 修复了在处置包装数据读取器时错误关闭内部读取器的问题
   • 这一改进避免了潜在的资源管理问题

4. 查询性能提升：

   • 优化了"QueryUnbuffered"方法的性能表现
   • 修正了"First"系列API的正确性问题

5. 动态对象处理改进：

   • 正确处理了值类型在动态对象属性设置时的问题
   • 提升了动态查询结果的准确性

6. 类型处理器API强化：

   • 将AddTypeHandlerImpl标记为过时
   • 防止通过AddTypeHandler导致的更新丢失问题

技术细节深入

查询性能优化

在底层实现上，Dapper团队对查询执行路径进行了精细调整。特别是对于无缓冲查询(QueryUnbuffered)，优化了内存分配策略和结果集处理流程。这种优化对于处理大型数据集特别有益，能够显著降低内存压力。

异步API标准化

跨不同.NET版本的异步行为现在更加一致。开发团队确保了在不同运行时环境下，异步操作的取消行为、异常传播和完成状态都遵循相同的模式。这种一致性对于构建可靠的跨平台应用至关重要。

动态对象处理增强

新版本改进了对动态类型(dynamic)返回值的处理逻辑。当查询结果映射到动态对象时，现在能够正确处理值类型(如int、DateTime等)的转换和赋值。这一改进解决了之前版本中可能出现的类型转换异常或值丢失问题。

升级建议

对于当前使用2.1.35或更早版本的用户，2.1.66版本是一个推荐的升级选择，它包含了多项稳定性修复和性能改进。但需要注意：

1. 如果应用依赖了2.1.37版本中的DateOnly/TimeOnly支持，需要评估这一变更的影响
2. 对于使用AddTypeHandlerImpl的代码，应考虑迁移到推荐的替代方案
3. 建议在升级前进行充分的测试，特别是涉及动态查询和异步操作的部分

总结

Dapper.NET 2.1.66版本虽然没有引入新功能，但在稳定性和性能方面做出了重要改进。这个版本体现了Dapper团队对产品质量的持续关注，特别是在处理边界条件和跨平台一致性方面的努力。对于追求稳定性和性能的.NET数据访问层来说，这个版本是一个值得考虑的选择。