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

项目简介

Dapper是一个轻量级的.NET对象关系映射(ORM)工具，由Stack Overflow团队开发并开源。它以高性能和简单易用著称，特别适合需要直接控制SQL查询但又不想处理底层ADO.NET复杂性的开发者。Dapper通过扩展方法的形式为IDbConnection接口添加了强大的查询功能，在.NET生态系统中广受欢迎。

版本核心变更

目标框架调整

2.1.66版本对支持的目标框架进行了重要更新：

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

这一变更反映了Dapper团队对长期支持版本的重视，确保用户能够获得最稳定的开发体验。同时，移除了不再维护的框架版本，减少了维护负担。

异步API标准化

本次发布对所有目标框架上的异步API进行了标准化处理。这意味着无论开发者使用哪个版本的.NET框架，都能获得一致的异步编程体验。这种一致性对于跨多个.NET版本维护代码库的团队尤为重要。

数据类型支持调整

2.1.37版本曾尝试引入对DateOnly和TimeOnly类型的支持，但由于存在多个故障模式，该功能被迅速回滚。2.1.66版本正式移除了这一实验性功能，回退到2.1.35版本的稳定状态。虽然这看起来是功能上的退步，但实际上是为了保证生产环境的稳定性而做出的必要决策。

重要改进

数据读取器处理优化

修复了一个关于内部读取器处理的重要问题。现在，当处理包装的数据读取器时，Dapper不会错误地关闭内部读取器。这一改进特别影响那些需要嵌套使用数据读取器的场景，确保了资源管理的正确性。

查询性能提升

对"QueryUnbuffered"和"First"系列API进行了显著优化：

• 改进了"QueryUnbuffered"的性能表现
• 修正了"First"系列API的正确性问题

这些优化使得处理大型数据集时内存使用更加高效，同时保证了获取首条记录操作的可靠性。

动态对象处理增强

修复了当Dapper查询返回动态对象时，值类型属性设置不正确的问题。这一改进确保了使用dynamic类型时的类型安全性，减少了运行时错误的可能性。

类型处理器API改进

标记AddTypeHandlerImpl方法为过时，并通过AddTypeHandler方法防止类型处理器更新丢失。这一变更引导开发者使用更安全的API来管理类型处理器，避免潜在的配置冲突。

开发者建议

对于正在使用受影响版本(2.1.37及附近版本)的开发者，升级到2.1.66版本需要注意：

1. 如果项目中使用了DateOnly/TimeOnly支持，需要暂时寻找替代方案，等待该功能的稳定实现
2. 检查项目中是否使用了过时的AddTypeHandlerImpl方法，迁移到推荐的AddTypeHandler
3. 评估异步API的标准化是否会影响现有代码
4. 对于性能敏感的应用，可以测试新版"QueryUnbuffered"和"First"API的改进效果

总结

Dapper 2.1.66版本虽然没有引入革命性的新功能，但在稳定性、性能和API一致性方面做出了重要改进。这些看似细微的调整实际上对生产环境的可靠性和开发体验有着深远影响。作为一个成熟的微型ORM工具，Dapper继续保持着其对性能的执着追求和对稳定性的高度重视，这也是它能在众多ORM解决方案中保持竞争力的关键原因。