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

项目简介

Dapper.NET是一个轻量级的对象关系映射(ORM)工具，作为.NET平台上的数据访问组件，它扩展了ADO.NET的功能，提供了简单高效的数据库操作方式。与Entity Framework等全功能ORM不同，Dapper以性能为核心，特别适合需要精细控制SQL查询的高性能应用场景。

版本更新概述

Dapper.NET 2.1.66版本是一个重要的稳定性更新版本，主要解决了之前版本中存在的几个关键问题，同时进行了多项性能优化和功能改进。这个版本特别值得关注的是它处理了2.1.37版本中引入但存在问题的DateOnly/TimeOnly支持功能。

主要变更内容

1. 目标框架更新

开发团队对支持的目标框架进行了调整：

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

这一变更确保了Dapper能够充分利用最新LTS版本的功能和性能优化，同时减少维护负担。

2. 异步API标准化

在此版本中，开发团队对所有目标框架上的异步API进行了标准化处理。这意味着无论开发者使用哪个版本的.NET框架，异步操作的API表现都将保持一致，减少了跨平台开发时的兼容性问题。

3. DateOnly/TimeOnly支持回退

2.1.37版本曾尝试引入对DateOnly和TimeOnly类型的支持，但发现存在多个故障模式。在2.1.66版本中，开发团队决定暂时禁用这一功能，待未来有足够时间进行彻底调查后再重新实现。这一决策体现了团队对稳定性的重视。

4. 数据读取器处理改进

修复了一个关于内部读取器处理的重要问题：现在当处理包装的数据读取器时，不再错误地关闭内部读取器。这一改进防止了在某些场景下可能出现的资源过早释放问题。

5. 查询性能优化

开发团队对"queryunbuffered"操作进行了性能优化，同时修正了"first"系列API的正确性问题。这些改进使得在处理大量数据时能够获得更好的性能表现，同时确保了API行为的正确性。

6. 动态对象处理改进

修复了当Dapper查询返回动态对象时，值类型属性设置不正确的问题。这一改进增强了动态查询场景下的类型处理能力。

7. 类型处理器API改进

标记AddTypeHandlerImpl方法为过时，并通过AddTypeHandler方法防止类型处理器更新丢失。这一变更引导开发者使用更安全的API来添加类型处理器。

技术细节深入

异步API标准化

在之前的版本中，不同目标框架上的异步API可能存在细微差异。2.1.66版本通过统一实现，确保了无论在哪个框架版本上，异步操作的行为都完全一致。这对于开发跨平台应用或库的开发者尤为重要。

查询性能优化细节

"queryunbuffered"优化的核心在于减少了不必要的缓冲操作，使得数据能够更高效地从数据库流向应用程序。同时，"first"API的修正确保了在特定边界条件下的正确行为，比如当查询结果为空时的处理方式。

动态对象处理机制

Dapper允许查询结果映射到动态对象，这在处理灵活的数据结构时非常有用。2.1.66版本改进了值类型在这种场景下的处理方式，确保了类型信息能够正确保留和转换。

升级建议

对于正在使用2.1.37或类似版本的用户，升级到2.1.66版本将恢复稳定性，但会暂时失去DateOnly/TimeOnly支持功能。考虑到这些功能在之前版本中实际上已被禁用很长时间，大多数用户不会感受到功能变化。

对于所有用户，特别是那些：

• 使用异步操作
• 处理大量数据查询
• 使用动态查询结果
• 需要长期支持(LTS)的.NET版本

升级到2.1.66版本将获得更好的稳定性、性能和一致性体验。

总结

Dapper.NET 2.1.66版本虽然没有引入大量新功能，但在稳定性和性能方面做出了重要改进。它解决了之前版本中的几个关键问题，优化了核心查询性能，并确保了API在不同平台上的行为一致性。这些改进使得Dapper继续保持其作为高性能.NET数据访问解决方案的领先地位。