FreeSql 中 MySQL DateTime 类型查询返回 null 问题的分析与解决

问题背景

在使用 FreeSql 3.5.102 版本连接 MySQL 5.7 数据库时，开发人员发现查询 datetime 类型字段时返回了 null 值。这个问题特别出现在联表查询返回匿名类型的情况下，而单表查询则表现正常。

问题分析

经过深入排查，发现问题的根源在于 FreeSql 对不同 MySQL 驱动包的处理方式不同：

1. 驱动包差异：

   • FreeSql 提供了两个 MySQL 驱动包：FreeSql.Provider.MySql 和 FreeSql.Provider.MySqlConnector
   • 使用 FreeSql.Provider.MySql 时，datetime 类型会被映射为 MySql.Data.Types.MySqlDateTime
   • 使用 FreeSql.Provider.MySqlConnector 时，datetime 类型会被映射为 MySqlConnector.MySqlDateTime

2. 版本差异：

   • 在 FreeSql 3.2.833 版本中，对于未知类型会默认尝试转换为 DateTime
   • 在 FreeSql 3.5.102 版本中，只处理了特定已知类型，未处理 MySqlDateTime 类型

3. 连接字符串影响：

   • 当连接字符串包含 Allow Zero Datetime=True 配置时，datetime 类型会被转换为 MySqlDataTime
   • 这种配置下，FreeSql.Provider.MySql 会出现读取日期为 null 的情况

解决方案

针对这一问题，开发团队提供了以下解决方案：

1. 临时解决方案： 可以通过 AOP 拦截数据读取过程，手动处理 MySqlDateTime 类型：

   fsql.Aop.AuditDataReader += (_, e) =>
   {
       switch (e.DataReader.GetFieldType(e.Index).FullName)
       {
           case "MySql.Data.Types.MySqlDateTime":
           case "MySqlConnector.MySqlDateTime":
               if (dr.IsDBNull(index)) e.Value = null;
               else e.Value = e.DataReader.GetDateTime(e.Index);
               break;
       }
   };
   

2. 推荐解决方案：

   • 升级到 FreeSql 最新版本（3.5.103 及以上）
   • 或者改用 FreeSql.Provider.MySqlConnector 驱动包

3. 连接字符串调整： 如果不必要，可以移除 Allow Zero Datetime=True 配置

最佳实践建议

1. 驱动选择：

   • 对于新项目，推荐使用 FreeSql.Provider.MySqlConnector
   • MySqlConnector 驱动性能更好，兼容性更强

2. 版本升级：

   • 定期检查并升级 FreeSql 版本
   • 升级前进行充分测试

3. 类型映射：

   • 对于关键日期字段，可以在实体类中明确指定类型：

     [Column(DbType = "datetime")]
     public DateTime? AddDate { get; set; }
     

4. 测试验证：

   • 在涉及日期字段的查询中，特别是联表查询和匿名类型返回时，需要进行充分测试
   • 验证各种边界情况下的日期处理是否正确

总结

FreeSql 作为一款优秀的 .NET ORM 框架，在处理 MySQL 日期类型时提供了灵活的解决方案。通过理解底层驱动差异和类型映射机制，开发人员可以避免类似问题。建议开发团队关注框架更新，选择合适的驱动包，并在关键业务场景中进行充分测试，以确保数据访问层的稳定性和可靠性。