Android 11分区存储下使用SQLite打开外部.db文件抛出无法打开异常

问题根源 #

你传入SQLiteDatabase.openDatabase的路径是存储访问框架(SAF)返回的虚拟路径，不是本地文件系统可识别的真实物理路径。SQLite的文件操作直接基于底层文件系统，无法解析SAF的虚拟路径格式，因此抛出目录不存在的异常。同目录txt可正常读写是因为文本文件可通过ContentResolver的流接口操作，不依赖真实文件路径。

解决方案 #

方案1：将db文件复制到应用私有目录操作（最简便，适合文件体积不大的场景） #

先通过SAF返回的Uri读取源db文件，复制到应用私有缓存/文件目录后再打开：

// 从SAF Uri获取输入流
InputStream inputStream = getContentResolver().openInputStream(dbFile.getUri());
// 生成私有目录下的临时db文件路径
File tempDb = new File(getCacheDir(), "temp_catalog.db");
// 执行文件复制
FileOutputStream outputStream = new FileOutputStream(tempDb);
byte[] buffer = new byte[1024];
int length;
while ((length = inputStream.read(buffer)) > 0) {
    outputStream.write(buffer, 0, length);
}
outputStream.flush();
outputStream.close();
inputStream.close();
// 打开私有目录下的db文件
SQLiteDatabase dbSQLite = SQLiteDatabase.openDatabase(tempDb.getAbsolutePath(), null, SQLiteDatabase.OPEN_READONLY);

如果修改后需要保存回原位置，操作完db后再将私有目录下的文件写回原SAF Uri即可。

方案2：使用自定义VFS对接SAF文件描述符（适合大文件避免复制开销） #

如果db文件体积较大、复制耗时久，可以实现自定义SQLite VFS层，通过ContentResolver拿到的文件描述符来读写SAF路径下的文件，不需要生成本地副本。该方案实现复杂度较高，需要熟悉SQLite的VFS接口开发。

注意事项 #

不要尝试通过反射、字符串拼接等方法将SAF Uri转换为真实路径，Android 11及以上版本对共享存储的访问限制严格，即使拼接出路径也会因为权限不足无法访问，只有应用私有目录的路径可以直接传给SQLite打开。

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