更新记录
1.0.2(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
1.0.1(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
1.0.0(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
查看更多平台兼容性
uni-app x(4.25)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| × | × | √ | × | √ | × |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
uni-sqlite-pro
开箱即用的原生本地数据库 UTS 插件。纯系统 API,无三方 SDK 依赖,一行 import 即可使用。
效果预览
MuMu 模拟器(Android 12)真机运行截图,图片托管在插件市场 CDN。

真机验证结果:数据库打开成功(路径 /data/user/0/io.dcloud.uniappx/files/demo.db)、插入返回 rowId 与影响行数、查询返回 4 条记录、诊断信息(opened=true, size=20480)均正常。
平台支持
| 平台 | 支持 | 说明 |
|---|---|---|
| Android | ✅ | minSdk 21,Kotlin 原生混编,标准基座可运行 |
| 鸿蒙 HarmonyOS | ✅ | ArkTS 原生混编(relationalStore),HBuilderX 4.61+ |
| iOS | 🚧 | 后期版本支持 |
| Web / 小程序 | ❌ | 请使用前端存储方案 |
快速开始(3 行代码)
import { openDB, execute, query } from '@/uni_modules/uni-sqlite-pro'
openDB({ name: 'demo', version: 1, success: () => console.log('打开成功') })
execute({ sql: "INSERT INTO user(name, age) VALUES(?, ?)", params: ['张三', 28] })
query({ sql: 'SELECT * FROM user', success: (res) => console.log(res.rows) })
打开数据库时会自动创建示例表:user(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER)。
API 清单
| 方法 | 参数 | 说明 |
|---|---|---|
openDB(options) |
{name, version, success?, fail?, complete?} |
打开/创建数据库,自动建表示例表 |
closeDB(options?) |
{success?, fail?, complete?} |
关闭数据库 |
execute(options) |
{sql, params?, ...} |
执行增删改,返回 rowId 与受影响行数 |
query(options) |
{sql, params?, ...} |
查询,返回 rows 与 columnCount |
transaction(options) |
{sqls, ...} |
事务,全部成功提交返回 1 |
backup(options) |
{path, ...} |
备份数据库文件到指定路径 |
getInfo(options) |
{success?, ...} |
诊断:opened/name/version/path/size |
isOpen() |
无 | 同步返回是否已打开 |
返回结构
成功回调统一返回:
{ errCode: 0, errMsg: 'ok', affected: number, rowId: number } // execute/transaction
{ errCode: 0, errMsg: 'ok', rows: any[], columnCount: number } // query
{ errCode: 0, errMsg: 'ok', opened, name, version, path, size } // getInfo
失败回调返回 uni 标准错误对象:errCode、errMsg、errSubject。
错误码
| 码 | 含义 |
|---|---|
| 9010001 | 数据库未打开,请先调用 openDB() |
| 9010002 | 打开数据库失败 |
| 9010003 | SQL 执行失败 |
| 9010004 | 参数错误 |
| 9010005 | 数据库文件不可写 |
| 9010006 | 备份失败 |
| 9010007 | 当前平台不支持 |
权限与隐私
- 数据库文件保存在应用私有目录(Android:
filesDir;鸿蒙:databaseDir),无需申请存储权限。 - 插件不采集任何数据,不访问网络。
常见问题
Q:修改原生代码后需要打自定义基座吗? A:Kotlin 混编代码标准基座真机运行即可生效;鸿蒙 ets 可直接真机运行。若引入三方 SDK 或新增资源才需自定义基座。
Q:params 占位符怎么用?
A:SQL 中用 ? 占位,params 按顺序传入,如 execute({ sql: '... VALUES(?,?)', params: ['a', 1] })。
Q:如何拿自增主键 id?
A:execute 成功返回的 rowId 即最后插入行的 id。
Q:事务失败会怎样?
A:任一 SQL 失败自动回滚,fail 回调返回 9010003。
更新记录
见 changelog.md。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 69
赞赏 0
下载 12775967
赞赏 1960
赞赏
京公网安备:11010802035340号