Ionic Capacitor经文件选择器选SQLite文件后无法打开的问题咨询

卡住的本质和你选哪种文件选择方案无关，核心是三类选择器返回的文件标识都不符合Ionic原生SQLite插件的访问规则：

• 安卓端Chooser、File Chooser返回的大多是*content://类型的临时授权URI*，不是文件系统的真实物理路径，临时访问权限仅在选择回调的生命周期内有效，SQLite插件本身不识别这类URI格式
• iOS端文件选择器返回的是App安全作用域外的文件路径，应用默认没有持久读写权限
• 所有版本的Ionic原生SQLite插件，默认只会加载应用自身沙盒目录下的数据库文件，沙盒外的路径无论怎么传参都无法被正常读取，会直接触发进程阻塞无响应

核心处理逻辑是：不要直接把选择器返回的原始路径传给SQLite插件，先把选中的数据库文件拷贝到SQLite插件可访问的沙盒专属目录，再调用插件打开拷贝后的文件。

步骤1：读取选中文件的原始二进制数据 #

不管用哪类文件选择器，优先拿文件的原始二进制内容，不要直接用返回的path/uri字段：

• 用<input type="file">实现选择逻辑的话，直接从event.target.files[0]拿到File对象即可，这是跨平台兼容性最高的方案
• 用原生Chooser/File Chooser插件的话，调用插件自带的文件读取方法拿到ArrayBuffer格式的文件内容，不要直接使用返回的uri

步骤2：将文件写入沙盒数据库专属目录 #

用@capacitor/filesystem插件，把拿到的数据库文件写入SQLite插件默认扫描的目录，跨平台统一选择Directory.Documents下自建的databases子文件夹即可，参考实现：

import { Filesystem, Directory } from '@capacitor/filesystem';

// 此处selectedFile为从文件选择器拿到的File对象
const fileReader = new FileReader();
fileReader.onload = async (loadEvent) => {
  const fileBuffer = loadEvent.target?.result as ArrayBuffer;
  // 自动创建目录并写入数据库文件
  await Filesystem.writeFile({
    path: `databases/${selectedFile.name}`,
    data: fileBuffer,
    directory: Directory.Documents,
    recursive: true
  });
};
// 必须以二进制格式读取，不能用文本格式避免破坏数据库结构
fileReader.readAsArrayBuffer(selectedFile);

步骤3：调用SQLite插件打开沙盒内的文件 #

文件写入完成后，直接传入写入时的文件名（不要拼接全路径）给SQLite插件的open方法，插件会自动到默认扫描的沙盒目录下加载对应文件，不会再出现卡住的问题。

平台额外配置 #

• 安卓端：在AndroidManifest.xml中添加对应权限配置，安卓13及以上不需要额外申请全存储权限，系统文件选择器会自动授予单文件临时读取权限，足够完成拷贝操作：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

• iOS端：在Info.plist中开启文档访问权限，保证SQLite插件能正常读取Documents目录下的文件：

<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

• 不要尝试网上流传的content://转真实物理路径方案，安卓10及以上版本系统已经封禁了这类跨沙盒路径访问的接口，转换后的路径依然没有读写权限
• 不要在文件选择器的回调里直接调用SQLite插件open方法传原始路径，临时授权在回调执行结束后就会被系统回收，必然触发访问失败
• 写入文件时必须用二进制格式读写，不要用UTF-8等文本编码转码，会直接破坏SQLite的文件结构，后续打开会提示数据库损坏

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