如何为SQLitePCL.raw.SetProvider()传参解决SqliteConnection类型初始化异常
这个报错和你的业务SQL代码、连接字符串配置无关,本质是没有在全局范围内正确初始化SQLitePCL的原生适配层。
Microsoft.Data.Sqlite 本身不内置原生SQLite引擎,所有底层操作都依赖SQLitePCL.raw对接各平台的原生SQLite库;适配层必须在第一次访问SqliteConnection类型之前完成初始化,否则在SqliteConnection的静态构造函数触发时,因为拿不到有效的已注册Provider,就会直接抛出“类型初始化器抛出异常”的运行时错误。
常见认知误区
- 这个报错和SQL逻辑、连接字符串格式没有关系,不要通过修改查询语句排查问题
- 不需要在每次创建
SqliteConnection的时候重复做初始化,全局启动阶段调用一次就够 - 不要把初始化调用放在业务方法、连接创建代码的后面,会因为执行顺序错误完全失效
你之前尝试手动调用SQLitePCL.raw.SetProvider()的思路方向正确,但完全不需要手动传参适配,99%的常规应用场景都不需要直接调用这个方法:
- 如果你通过Nuget安装的是带原生库打包的
Microsoft.Data.Sqlite主包(而非仅安装无原生依赖的Microsoft.Data.Sqlite.Core),只需要在应用启动的最入口(比如UWP项目的App.xaml.cs的OnLaunched方法、控制台项目的Main方法),全局调用一次初始化代码即可,不需要在每次创建连接前重复执行:SQLitePCL.Batteries_V2.Init(); - 为什么不推荐手动调
SetProvider()?
这个方法要求传入实现了SQLitePCL.ISQLite3Provider接口的实例,实例和你引用的原生SQLite库是强绑定的:比如引用e_sqlite3原生包就需要传Provider_e_sqlite3的实例,引用官方sqlite3原生包就要传对应平台的Provider实现。手动传参很容易出现版本不匹配、平台兼容问题,而Batteries_V2.Init()会自动根据当前运行环境、已安装的Nuget包,加载匹配的Provider,完全不需要手动处理参数。
- 调用顺序错误:你把初始化代码放在了
new SqliteConnection(connStr)之后,这时候SqliteConnection的静态构造函数已经在执行new的那一行触发完成了,如果初始化未完成就会直接抛异常,后面写的初始化代码根本不会被执行到。 - 方法调用错误:你写的
SQLitePCL.raw.SetProvider()没有传入必需的参数,本身就无法通过编译,自然不可能解决运行时问题。
把初始化逻辑挪到全局启动入口,原有业务代码保持原样即可:
// 以UWP项目为例,App.xaml.cs的启动逻辑 protected override void OnLaunched(LaunchActivatedEventArgs e) { // 启动阶段第一行执行全局SQLite初始化 SQLitePCL.Batteries_V2.Init(); // 以下为原有启动逻辑,无需修改 Frame rootFrame = Window.Current.Content as Frame; if (rootFrame == null) { rootFrame = new Frame(); Window.Current.Content = rootFrame; } if (rootFrame.Content == null) { rootFrame.Navigate(typeof(MainPage), e.Arguments); } Window.Current.Activate(); }
你原来写的InsertMapRecord、btnCre8NewMap_Click方法完全不需要调整,保持原有的using (SqliteConnection conn = new SqliteConnection(connStr))写法即可。
特殊场景说明
如果你的项目是定制化编译的SQLite原生库,确实需要手动指定Provider,那么SetProvider()的传参格式示例为(以e_sqlite3为例):
SQLitePCL.raw.SetProvider(new SQLitePCL.Provider_e_sqlite3());
这种写法仅适用于特殊定制场景,普通应用无需手动处理。另外如果只安装了Microsoft.Data.Sqlite.Core包没有配套的原生bundle包,哪怕初始化代码写对了也会报错,需要补充安装SQLitePCL.raw_bundle或者直接换用带原生依赖的Microsoft.Data.Sqlite主包。
内容的提问来源于stack exchange,提问作者B. Clay Shannon-B. Crow Raven

