FreeSql 对 PostgreSQL 中 DateOnly 和 TimeOnly 类型的支持演进

在 .NET 开发中，处理日期和时间是常见的需求。随着 .NET 6 引入了 DateOnly 和 TimeOnly 这两个新类型，开发者能够更精确地处理日期和时间数据。然而，在 ORM 框架中如何与数据库类型正确映射，特别是像 PostgreSQL 这样的数据库，成为了一个值得探讨的技术话题。

FreeSql 作为一款流行的 .NET ORM 框架，近期在其 3.5.100 预览版本中逐步完善了对 PostgreSQL 中 DateOnly 和 TimeOnly 类型的支持。这一演进过程反映了 ORM 框架在处理新型数据类型时面临的挑战和解决方案。

初始支持阶段

FreeSql 最初在 MSSQL Server 中实现了对 DateOnly 和 TimeOnly 的完整支持，但在 PostgreSQL 中的支持相对滞后。这主要是因为 PostgreSQL 的 .NET 数据提供程序 Npgsql 在这些类型的处理上存在版本兼容性问题。

技术挑战

主要的技术挑战来自两个方面：

1. Npgsql 版本兼容性问题：不同版本的 Npgsql 对 DateOnly 和 TimeOnly 的处理方式不同。较新版本的改动较大，升级会导致类型加载错误；而低版本又无法正确处理这些类型。

2. 类型转换问题：在查询阶段，框架需要正确处理 TimeSpan 到 TimeOnly 的类型转换，否则会抛出"Object must implement IConvertible"异常。

解决方案演进

FreeSql 团队通过多个预览版本的迭代逐步解决了这些问题：

1. 在 3.5.100-preview20240815 版本中初步实现了存储功能，但查询时仍存在类型转换问题。

2. 经过分析，发现问题根源在于 Npgsql 改变了传统 ADO.NET 的使用习惯，造成了进退两难的局面。

3. 最终在 3.5.100-preview20240821 版本中彻底解决了所有已知问题，实现了完整的支持。

开发者注意事项

对于需要使用这些特性的开发者，建议：

1. 确保使用 FreeSql 3.5.100-preview20240821 或更高版本。

2. 注意 Npgsql 驱动版本的兼容性，避免混合使用不兼容的版本。

3. 在迁移现有项目时，注意检查涉及日期时间类型的查询和存储逻辑。

总结

FreeSql 对 PostgreSQL 中 DateOnly 和 TimeOnly 的支持演进展示了 ORM 框架在处理新型数据类型时的典型挑战和解决路径。通过版本迭代，最终实现了稳定可靠的支持，为开发者提供了更完善的类型处理能力。这一过程也提醒我们，在使用新型数据类型时，需要关注框架和驱动程序的版本兼容性，以确保系统的稳定运行。