App端必须用自定义基座+插件，H5/小程序不支持SQLite；官方未内置相关API，调用会报错；唯一可行路径是打包为App并启用自定义调试基座，安装uni-sqlite等插件，且需在manifest.json中显式开启权限。
App端必须用自定义基座+插件，H5/小程序根本不行
uni-app 官方不内置 SQLite 支持，uni.getSQLiteSync、uni.openDatabase 这类 API 在 H5 和微信小程序里直接调用会报 undefined is not a function 或 not supported。真机调试时即使写了代码也完全没反应——因为底层压根没实现。
唯一可行路径是：打包为 App（iOS/Android），且必须启用「自定义调试基座」，再安装 DCloud 插件市场里的 SQLite 插件（如 uni-sqlite 或 uni-plugin-sqlite）。npm install 不起作用，图形化安装后还要在 manifest.json 里显式开启 SQLite 模块权限。
- Android 端首次运行前，需主动申请
android.permission.WRITE_EXTERNAL_STORAGE权限，否则openDatabase会静默失败 - 数据库文件路径不能写
/static/xxx.db—— static 是只读资源目录，写入必报错；应使用_doc/xxx.db或_www/xxx.db等可写沙盒路径 - H5 场景别硬扛 SQLite，改用
sql.js（WASM 实现，体积 >1MB）或退回到uni.setStorage+ JSON 模拟表结构
初始化 db 对象必须 await + try/catch，exec 不支持多语句
插件返回的 db 对象不是立即可用的同步对象，init() 或 openDatabase() 是异步过程，且建库建表逻辑在首次执行时才触发。跳过 await 直接 exec，大概率得到空结果或 sqlite error: near "xxx" 这类模糊语法错误。
更关键的是：exec 只接受单条 SQL 语句。传入 "CREATE TABLE a; CREATE TABLE b;" 会直接报错，也不能在一个 exec 里塞 INSERT + UPDATE。
- 建表必须单独
await db.exec('CREATE TABLE ...')，每条语句独立调用 - 参数绑定强制用
?占位符，例如db.exec('INSERT INTO user (name) VALUES (?)', ['张三'])；拼字符串极易引发注入和引号转义问题 - 插入后要取自增 ID，得读
db.lastInsertRowId字段，不是返回值里的insertId - 所有 exec / selectAll 操作都建议包在 try/catch 里，错误对象的
e.message才是真实报错内容
查询结果字段名大小写敏感，且带双引号
SQLite 插件返回的查询数据（比如 selectAll 结果），字段名完全按建表 SQL 中写的原始形式保留：包括大小写和双引号。如果你建表写的是 CREATE TABLE user ("Name" TEXT, "age" INTEGER)，那结果就是 {"Name": "张三", "age": 25}，不是小写的 name 或驼峰 userName。
很多开发者直接写 row.name 或 row.userName，结果拿到 undefined 却查不出原因——因为字段名根本对不上。
- 建表时统一用小写下划线命名（如
user_name），避免大小写歧义 - 查询后取值必须严格匹配建表语句中的字段标识，区分大小写
- 如果用了双引号包裹字段（如
"UserName"），取值时也得写row["UserName"] - 不要依赖 IDE 自动补全字段名，它不会按 SQLite 插件的实际返回结构提示
没有自动事务回滚，批量操作得手动控制
uni-app SQLite 插件普遍不提供 transaction 方法（不像 Web SQL），也没有隐式事务。一次 exec 就是一次独立执行，失败了不会自动回滚前面成功的语句。
要做原子性批量操作（比如“扣库存 + 记日志”必须同时成功或同时失败），只能靠业务层手动兜底：先 exec 所有语句，再检查每一步的返回状态；任一失败，就用反向 SQL 补偿（如把刚加的库存再减回去），或者提前预占资源。
- 避免在单个页面生命周期里反复 open/close 数据库，连接开销大；推荐在
App.vue初始化一次并挂载到全局 - 批量插入不要循环多次
exec，改用INSERT INTO ... VALUES (...), (...), (...)单语句多行值提升性能 - 表结构变更（如加字段）必须走版本迁移逻辑，不能直接
ALTER TABLE—— 首次建表后，后续字段增删需在 init 后判断当前版本再执行对应 SQL - 真机调试务必用自定义基座，普通云编译基座不加载插件，所有 SQLite 调用都会失效
