FreeSql项目中使用SqliteCore连接SQLite数据库的注意事项

在使用FreeSql ORM框架连接SQLite数据库时，开发者可能会遇到一个常见问题：当同时安装了FreeSql.Provider.Sqlite和FreeSql.Provider.SqliteCore两个NuGet包时，系统默认会使用Sqlite提供程序，这可能导致某些功能无法正常工作或出现程序集加载错误。

问题背景

FreeSql为SQLite数据库提供了两种不同的提供程序实现：

1. FreeSql.Provider.Sqlite - 基于System.Data.SQLite的实现
2. FreeSql.Provider.SqliteCore - 基于Microsoft.Data.Sqlite的实现

当项目中同时存在这两个包时，FreeSql会默认选择System.Data.SQLite的实现方式，这可能导致以下问题：

• 程序集加载失败错误
• 功能不兼容
• 性能差异

解决方案

要明确指定使用SqliteCore提供程序，可以通过以下方式配置FreeSql连接：

UseConnectionStrings(
    DataType.Sqlite,
    "连接字符串",
    Type.GetType("FreeSql.Sqlite.SqliteProvider`1,FreeSql.Provider.SqliteCore")
);

这种配置方式明确告诉FreeSql使用SqliteCore提供程序，避免了自动选择可能带来的问题。

深入理解

1. 两种提供程序的差异

System.Data.SQLite和Microsoft.Data.Sqlite是两种不同的SQLite ADO.NET实现：

• System.Data.SQLite：

  • 历史悠久，功能全面
  • 需要额外的本地库文件
  • 在某些场景下性能较好

• Microsoft.Data.Sqlite：

  • 微软官方维护
  • 更轻量级
  • 与.NET Core/.NET 5+集成更好
  • 跨平台支持更佳

2. 为什么会出现默认选择问题

FreeSql的设计允许通过NuGet包自动注册提供程序，但当存在多个提供程序时，框架需要明确的指示使用哪一个。在.NET Framework环境下，包管理有时不能完全清理旧版本程序集，导致运行时仍然加载了不期望的提供程序。

最佳实践

1. 单一提供程序原则：除非有特殊需求，否则建议项目只安装一个SQLite提供程序包。

2. 明确指定提供程序：当确实需要同时安装两个包时，务必在连接字符串配置中明确指定使用哪个提供程序。

3. 清理旧版本：在.NET Framework项目中，更换提供程序后应手动清理bin和obj目录，确保旧版本程序集不会残留。

4. 性能考量：根据应用场景选择合适的提供程序，Microsoft.Data.Sqlite通常在新项目中是更好的选择。

总结

FreeSql框架提供了灵活的数据库提供程序选择机制，但这也要求开发者在特定场景下需要明确指定使用哪个提供程序。理解不同SQLite提供程序的特点和差异，能够帮助开发者做出更适合项目需求的选择，避免运行时出现意外的兼容性问题。