Xamarin Forms中UWP平台SQLiteConnection对象操作异常求助

我之前在Xamarin Forms做跨端项目时，UWP端碰到过和你完全一样的问题——iOS、Android都能正常操作SQLite，唯独UWP一碰SQLiteConnection就抛空引用（应该是你说的「Object re...」截断的异常），折腾了好一阵才解决，给你分享几个关键排查点：

1. 确认UWP项目的SQLite依赖配置是否正确 #

UWP对SQLite的依赖逻辑和移动端不一样，这是最容易踩坑的点：

• 优先给UWP项目安装**SQLite-net-pcl** NuGet包，同时配套安装SQLitePCLRaw.bundle_green——这个包会自动处理UWP需要的原生SQLite库依赖；
• 还要在Visual Studio的「扩展管理器」里安装「SQLite for Universal Windows Platform」扩展（路径：工具→扩展和更新→联机搜索），不然UWP运行时会找不到底层的SQLite原生组件。

2. 检查UWP端的数据库路径是否合法 #

UWP的文件系统权限和移动端差异很大，不能直接用移动端的路径获取方式，正确的本地数据库路径应该这么写：

public string GetDatabasePath(string dbFileName)
{
    // UWP只能访问应用沙箱内的路径，这里取本地存储文件夹
    return Path.Combine(Windows.Storage.ApplicationData.Current.LocalFolder.Path, dbFileName);
}

如果之前用的是Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData)，在UWP环境下可能会返回无效路径，直接导致SQLiteConnection初始化失败。

3. 排查SQLiteConnection的初始化逻辑 #

确保UWP端的接口实现里，连接实例没有空引用：

• 初始化连接时必须传入上面方法获取的合法路径；
• 如果没用到数据库加密，不要额外传加密密钥参数；
• 初始化后一定要检查connection对象是否为null，比如：

var dbPath = GetDatabasePath("MyApp.db3");
var connection = new SQLiteConnection(dbPath);
if (connection == null)
{
    throw new InvalidOperationException("SQLite连接初始化失败，请检查路径和依赖");
}

4. 验证数据库模型类的UWP兼容性 #

UWP对SQLite的字段类型要求更严格，检查你的模型类：

• 主键字段必须标记[PrimaryKey, AutoIncrement]特性；
• 避免使用UWP不支持的.NET类型，比如DateTimeOffset，改用DateTime；
• 所有字段类型要和SQLite原生类型对应（比如int对应INTEGER，string对应TEXT）。

5. 获取完整的异常信息定位问题 #

你看到的「Object re...」是被截断的异常，建议开启详细异常捕获：

• 在Visual Studio中，点击「调试」→「Windows」→「异常设置」，勾选「Common Language Runtime Exceptions」；
• 运行时捕获到异常后，查看「异常详情」里的完整堆栈和消息，这能直接帮你定位到哪一行代码、哪个对象为空。

我当时就是因为没装UWP的SQLite扩展，加上路径获取错误导致的问题，调整后就正常运行了，你可以按上面的步骤逐一排查试试。

内容的提问来源于stack exchange，提问作者Aphire