FreeSql 解决 SqliteCore 与 Sqlite 包冲突问题

问题背景

在使用 FreeSql 连接 SQLite 数据库时，开发者可能会遇到一个常见问题：当同时安装了 FreeSql.Provider.Sqlite 和 FreeSql.Provider.SqliteCore 两个 NuGet 包时，系统会默认使用 Sqlite 提供程序，这可能导致一些兼容性问题或功能限制。

问题表现

具体表现为在 .NET Framework 4.8 环境下运行时，系统抛出异常提示"未能加载文件或程序集 System.Data.SQLite.SEE.License"，这实际上是包管理冲突导致的问题。

根本原因

这个问题源于 .NET Framework 的包管理机制存在缺陷，当两个包同时存在时：

1. 系统会默认优先使用 FreeSql.Provider.Sqlite
2. 即使卸载了 Sqlite 包，bin 目录中的相关文件可能未被完全清除
3. 这种残留会导致运行时仍然尝试加载旧版本的组件

解决方案

FreeSql 提供了明确的解决方案，可以通过在连接字符串配置时显式指定提供程序类型来解决此问题：

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

技术原理

这种解决方案的核心在于：

1. 通过第三个参数显式指定要使用的提供程序类型
2. 使用反射机制动态加载 FreeSql.Provider.SqliteCore 程序集中的 SqliteProvider 实现
3. 绕过默认的提供程序选择逻辑，确保使用正确的实现

最佳实践建议

1. 在明确需要使用 SqliteCore 提供程序的项目中，建议仅安装 FreeSql.Provider.SqliteCore 包
2. 如果确实需要同时使用两个提供程序，务必使用上述显式指定类型的方式
3. 清理项目时，手动检查 bin 和 obj 目录，确保没有旧版本组件的残留
4. 在 .NET Framework 项目中特别注意此问题，因为其包管理机制相对较弱

扩展知识

SqliteCore 提供程序相比标准 Sqlite 提供程序的主要优势在于：

1. 更好的跨平台支持
2. 更轻量级的依赖
3. 更现代的底层实现
4. 更好的性能表现

理解这一机制不仅有助于解决当前问题，也为处理类似的多提供程序选择场景提供了参考模式。