uni-app 中 SQLite 需通过原生插件实现，H5 端用 IndexedDB（iOS 限制严），App 端推荐 DCloud 官方 SQLite 插件；初始化须平台判断并等待就绪，建表加 IF NOT EXISTS；批量插入需事务或单语句多值；路径仅支持 _www/、_documents/、_downloads/，iOS 首次建库必须用 _documents/。
uni-app 里 SQLite 不是开箱即用的
uni-app 官方不支持直接调用 SQLite，uni.setStorage 和 uni.getStorage 只能存小数据（最大 10MB，且序列化后体积膨胀快），遇到几万条记录、带索引查询、事务操作等需求时，纯 localStorage 或 uniStorage 会卡死或崩溃。
真正能用 SQLite 的路径只有一条：通过原生插件桥接。iOS 需用 WKWebView + SQLite.framework，Android 需用 SQLiteOpenHelper 或 Room 封装；uni-app 本身运行在 WebView 或 weex 渲染层，没有底层数据库访问权限。
- 别试
cordova-sqlite-storage或sqlite3-wasm：前者依赖 Cordova 环境（uni-app 不兼容），后者在 H5 端可用但性能差、不支持事务、无法持久化（WASM 内存数据刷新即丢） - H5 端只能用
IndexedDB替代，但 iOS Safari 对 IndexedDB 的稳定性、容量限制（常被限制在 50MB 且无明确提示）比 Android 更严 - App 端必须上原生插件，推荐用 DCloud 官方插件市场里的
sqlite插件（如 “SQLite 数据库” 插件 ID：DCloud-uniPlugin-SQLite），它已封装好 Promise 接口和基础 CRUD
App 端 SQLite 插件怎么初始化和建表
插件安装后，不能像 Node.js 那样直接 require('sqlite3')。必须先调用 uni.requireNativePlugin 加载原生模块，再执行 open / exec 操作。
常见错误是忽略平台判断和异步时机：插件在 H5 下返回 undefined，未判空就调 open() 会报 Cannot read property 'open' of undefined；或者在 onLaunch 里没等插件 ready 就建表，导致 no such table。
- 初始化必须加平台守卫：
if (uni.getSystemInfoSync().platform === 'app-android' || uni.getSystemInfoSync().platform === 'app-ios') - 建表语句要带
IF NOT EXISTS，否则热更新或重复启动时可能报table xxx already exists - 字段类型别写
INTEGER PRIMARY KEY AUTOINCREMENT：Android 原生 SQLite 对AUTOINCREMENT有额外开销，普通INTEGER PRIMARY KEY就够用，自增行为不变
const db = uni.requireNativePlugin('SQLite');
db.open({ name: 'mydb.db', path: '_www/db/' }, (res) => {
db.exec({
sql: 'CREATE TABLE IF NOT EXISTS user (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)'
});
});
大数据量插入为什么慢？怎么批量提速
单条 INSERT INTO 执行一次 JS → 原生通信，1000 条就是 1000 次跨桥调用，实测在低端安卓机上耗时超 8 秒。瓶颈不在 SQLite 本身，而在通信链路。
正确做法是把 SQL 拼成一条多值插入语句，或用事务包住所有操作。但要注意：原生插件是否支持 exec 传入多语句数组？多数插件只支持单条 SQL 字符串，且不自动开启事务。
- 优先用事务：
db.beginTransaction()→db.exec(...)× N →db.commitTransaction()，避免每条都刷盘 - 单条 INSERT 多值写法：
INSERT INTO user VALUES (1,'a',20),(2,'b',22),(3,'c',21);—— 注意部分插件对括号嵌套敏感，需测试上限（一般 ≤ 500 组） - 别在循环里反复
db.exec：即使开了事务，JS 层频繁调用仍拖慢整体速度 - 如果数据来自 API，建议先
JSON.stringify存本地文件，再用原生插件读取解析入库，绕过 JS 层拼接
离线查不出数据？检查这三处硬限制
不是代码写错，而是 SQLite 在 uni-app 环境下有三个隐蔽但致命的路径/权限规则：
-
path参数不能写绝对路径（如/data/data/xxx/），必须用相对路径，且仅支持_www/、_documents/、_downloads/三个前缀目录；写错会导致数据库静默创建在错误位置，查不到数据 - iOS 上
_www/目录只读，首次建库必须用_documents/，否则open成功但后续exec全失败，错误信息是SQLITE_CANTOPEN - Android 10+ 强制分区存储，插件若没申请
android.permission.WRITE_EXTERNAL_STORAGE（targetSdkVersion MANAGE_EXTERNAL_STORAGE（≥ 30），写库文件会静默失败，日志里只有open failed没细节
最稳妥的路径写法：path: '_documents/db/'，配合 name: 'cache.db'，全平台兼容性最高。
