UniApp集成SQLite數(shù)據(jù)庫的完整方法步驟
更新時間：2026年04月19日 11:48:40 作者：Rysxt
在uni-app中集成SQLite,可以實現(xiàn)離線數(shù)據(jù)存儲,例如在物資管理APP中存儲商品信息、出入庫記錄等,這篇文章主要介紹了UniApp集成SQLite數(shù)據(jù)庫的相關(guān)資料,需要的朋友可以參考下
一、背景介紹
在移動應(yīng)用開發(fā)中，本地數(shù)據(jù)存儲是至關(guān)重要的功能。UniApp 作為一款跨平臺開發(fā)框架，支持一次編寫代碼發(fā)布到多個平臺（iOS、Android、H5、小程序等）。而 SQLite 是一款輕量級的嵌入式關(guān)系型數(shù)據(jù)庫，具有高效、可靠和安全的特點。
將 UniApp 與 SQLite 結(jié)合，可以實現(xiàn)本地數(shù)據(jù)的持久化存儲，特別適合在離線狀態(tài)下的數(shù)據(jù)操作需求，以及需要存儲大量結(jié)構(gòu)化數(shù)據(jù)的應(yīng)用場景，如日志記錄、離線緩存、本地配置管理等。
二、核心使用場景
- ??離線應(yīng)用??：在沒有網(wǎng)絡(luò)連接的情況下，應(yīng)用仍能正常使用本地數(shù)據(jù)
- ??數(shù)據(jù)緩存??：緩存服務(wù)器數(shù)據(jù)，減少網(wǎng)絡(luò)請求，提升用戶體驗
- ??配置管理??：存儲用戶設(shè)置、應(yīng)用配置等持久化數(shù)據(jù)
- ??日志記錄??：記錄應(yīng)用運行日志，便于問題排查
- ??復(fù)雜數(shù)據(jù)存儲??：需要關(guān)系型數(shù)據(jù)庫支持的復(fù)雜數(shù)據(jù)結(jié)構(gòu)存儲
三、環(huán)境準(zhǔn)備與平臺支持
3.1 平臺支持情況
- ??App（Android/iOS）??：完全支持 SQLite 數(shù)據(jù)庫
- ??H5??：不支持 SQLite，需使用 WebSQL 或 IndexedDB 替代
- ??小程序??：部分支持，需使用小程序自帶的數(shù)據(jù)庫 API
3.2 插件選擇
推薦使用以下插件之一：
- ??uni-sqlite??：官方推薦的 SQLite 插件
- ??se-sqlite??：基于 UniApp X + UTS 開發(fā)的本地數(shù)據(jù)庫操作插件，支持 ORM 面向?qū)ο蟮哪Ｐ突_發(fā)方式
- ??lime-sqlite??：參考 plus.sqlite API 實現(xiàn)的 SQLite UTS API 組件
四、配置步驟
4.1 安裝插件
在 HBuilderX 中安裝 SQLite 插件：
- 打開 HBuilderX，進(jìn)入項目
- 點擊菜單「工具」->「插件安裝」
- 搜索「sqlite」，安裝「uni-sqlite」插件
4.2 manifest.json 配置
在項目的 manifest.json 文件中配置 SQLite 權(quán)限：
{
"app-plus": {
"modules": {
"SQLite": {}
}
}
}或者通過圖形化界面配置：
- 打開 manifest.json
- 進(jìn)入「App模塊權(quán)限配置」
- 勾選 SQLite（數(shù)據(jù)庫）選項
五、數(shù)據(jù)庫操作封裝
5.1 基礎(chǔ)數(shù)據(jù)庫操作封裝
創(chuàng)建 static/sql/sqllite.js 文件進(jìn)行統(tǒng)一管理：
// 數(shù)據(jù)庫名稱和路徑配置
const sqlName = "mydatabase"
const sqlPath = "_doc/mydatabase.db"
// 打開數(shù)據(jù)庫
function openDb(name, path) {
return new Promise((resolve, reject) => {
plus.sqlite.openDatabase({
name: name,
path: path,
success: function(e) {
console.log('數(shù)據(jù)庫打開成功')
resolve(e)
},
fail: function(e) {
console.log('數(shù)據(jù)庫打開失敗:' + JSON.stringify(e))
reject(e)
}
})
})
}
// 判斷數(shù)據(jù)庫是否打開
function isOpened(name, path) {
return plus.sqlite.isOpenDatabase({
name: name,
path: path
})
}
// 關(guān)閉數(shù)據(jù)庫
function closeDb(name) {
return new Promise((resolve, reject) => {
plus.sqlite.closeDatabase({
name: name,
success: function(e) {
console.log('數(shù)據(jù)庫關(guān)閉成功')
resolve(e)
},
fail: function(e) {
console.log('數(shù)據(jù)庫關(guān)閉失敗')
reject(e)
}
})
})
}
// 查詢SQL（所有查詢都用該方法）
function selectSql(name, sqlText) {
return new Promise((resolve, reject) => {
plus.sqlite.selectSql({
name: name,
sql: sqlText,
success: function(e) {
resolve(e)
},
fail: function(e) {
console.log('查詢失敗:' + sqlText + "-異常信息:" + JSON.stringify(e))
reject(e)
}
})
})
}
// 執(zhí)行增刪改查都使用該方法
function executeSql(name, sqlText) {
return new Promise((resolve, reject) => {
plus.sqlite.executeSql({
name: name,
sql: sqlText,
success: function(e) {
console.log('操作成功')
resolve(e)
},
fail: function(e) {
console.log('執(zhí)行失敗:' + sqlText + '-異常信息:' + JSON.stringify(e))
reject(e)
}
})
})
}
export { sqlName, sqlPath, openDb, isOpened, closeDb, selectSql, executeSql }5.2 表結(jié)構(gòu)定義
創(chuàng)建 static/sql/tables.js 文件定義表結(jié)構(gòu)：
import { sqlName, executeSql } from "./sqllite.js"
export function userTable() {
let createSql = {
name: "user",
sql: "id INTEGER PRIMARY KEY AUTOINCREMENT, userId VARCHAR(255) NOT NULL, userName VARCHAR(255) NOT NULL, email VARCHAR(255), createdTime DATETIME DEFAULT CURRENT_TIMESTAMP"
}
executeSql(sqlName, `create table if not exists ${createSql.name} (${createSql.sql})`)
}
export function productTable() {
let createSql = {
name: "product",
sql: "id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR(255) NOT NULL, price REAL NOT NULL, stock INTEGER DEFAULT 0, category VARCHAR(100)"
}
executeSql(sqlName, `create table if not exists ${createSql.name} (${createSql.sql})`)
}六、應(yīng)用初始化
在 App.vue 中初始化數(shù)據(jù)庫：
import { sqlName, sqlPath, openDb, isOpened } from "./static/sql/sqllite.js"
import { userTable, productTable } from "./static/sql/tables.js"
export default {
onLaunch() {
this.initDatabase()
},
methods: {
async initDatabase() {
try {
// 判斷數(shù)據(jù)庫是否已打開
let type = isOpened(sqlName, sqlPath)
if (!type) {
// 打開數(shù)據(jù)庫
await openDb(sqlName, sqlPath)
// 創(chuàng)建表結(jié)構(gòu)
userTable()
productTable()
console.log('數(shù)據(jù)庫初始化完成')
}
} catch (error) {
console.error('數(shù)據(jù)庫初始化失敗:', error)
}
}
}
}七、CRUD 操作示例
7.1 數(shù)據(jù)操作封裝
創(chuàng)建 static/sql/user.js 文件：
import { sqlName, selectSql, executeSql } from "./sqllite.js"
const name = sqlName
// 查詢所有用戶
export function getAllUsers() {
let sql = "SELECT * FROM user ORDER BY createdTime DESC"
return selectSql(name, sql)
}
// 根據(jù)ID查詢用戶
export function getUserById(id) {
let sql = `SELECT * FROM user WHERE id = ${id}`
return selectSql(name, sql)
}
// 添加用戶
export function addUser(userData) {
let sql = `INSERT INTO user (userId, userName, email) VALUES ('${userData.userId}', '${userData.userName}', '${userData.email}')`
return executeSql(name, sql)
}
// 更新用戶
export function updateUser(id, userData) {
let sql = `UPDATE user SET userName = '${userData.userName}', email = '${userData.email}' WHERE id = ${id}`
return executeSql(name, sql)
}
// 刪除用戶
export function deleteUser(id) {
let sql = `DELETE FROM user WHERE id = ${id}`
return executeSql(name, sql)
}7.2 在頁面中使用
在 Vue 組件中使用數(shù)據(jù)庫操作：
import { getAllUsers, addUser, updateUser, deleteUser } from "@/static/sql/user.js"
export default {
data() {
return {
users: [],
newUser: {
userId: '',
userName: '',
email: ''
}
}
},
async onLoad() {
await this.loadUsers()
},
methods: {
async loadUsers() {
try {
const result = await getAllUsers()
this.users = result
} catch (error) {
console.error('加載用戶失敗:', error)
uni.showToast({
title: '加載失敗',
icon: 'none'
})
}
},
async handleAddUser() {
if (!this.newUser.userName || !this.newUser.userId) {
uni.showToast({
title: '請?zhí)顚懲暾畔?,
icon: 'none'
})
return
}
try {
await addUser(this.newUser)
uni.showToast({
title: '添加成功',
icon: 'success'
})
this.newUser = { userId: '', userName: '', email: '' }
await this.loadUsers()
} catch (error) {
console.error('添加用戶失敗:', error)
uni.showToast({
title: '添加失敗',
icon: 'none'
})
}
},
async handleDeleteUser(id) {
try {
await deleteUser(id)
uni.showToast({
title: '刪除成功',
icon: 'success'
})
await this.loadUsers()
} catch (error) {
console.error('刪除用戶失敗:', error)
uni.showToast({
title: '刪除失敗',
icon: 'none'
})
}
}
}
}八、高級功能
8.1 事務(wù)處理
批量操作時使用事務(wù)保證數(shù)據(jù)一致性：
export const batchInsert = (table, dataArray) => {
plus.sqlite.transaction({
name: dbName,
operation: async () => {
for (const data of dataArray) {
await insertData(table, data)
}
}
})
}8.2 索引優(yōu)化
為高頻查詢字段創(chuàng)建索引提升查詢性能：
plus.sqlite.executeSql({
name: dbName,
sql: "CREATE INDEX IF NOT EXISTS idx_user_name ON user(userName)"
})8.3 條件查詢封裝
封裝通用的條件查詢方法：
export const selectWithConditions = (table, conditions = {}) => {
let sql = `SELECT * FROM ${table}`
const keys = Object.keys(conditions)
if (keys.length > 0) {
sql += ' WHERE '
sql += keys.map(key => `${key} = '${conditions[key]}'`).join(' AND ')
}
return selectSql(dbName, sql)
}九、性能優(yōu)化策略
- ??索引優(yōu)化??：為高頻查詢字段創(chuàng)建索引
- ??批量操作??：使用事務(wù)減少 IO 開銷
- ??路徑優(yōu)化??：Android 10+ 使用
_doc/目錄避免權(quán)限問題 - ??連接管理??：合理管理數(shù)據(jù)庫連接，避免頻繁打開關(guān)閉
- ??查詢優(yōu)化??：避免 SELECT *，只查詢需要的字段
十、跨平臺兼容方案
10.1 條件編譯處理
使用 uni-app 的條件編譯區(qū)分平臺：
// #ifdef APP-PLUS
import { openDb } from './db/sqlite'
// #endif
// #ifdef H5
const openDb = () => Promise.resolve(mockDb)
// #endif10.2 H5 環(huán)境模擬
在瀏覽器調(diào)試時使用內(nèi)存數(shù)據(jù)庫模擬：
const mockDb = {
users: [],
executeSql: (sql) => {
if (sql.includes("INSERT")) {
const name = sql.match(/VALUES\s*\('(.*?)'\)/)[1]
mockDb.users.push({ name })
}
return Promise.resolve()
}
}十一、調(diào)試與維護(hù)
11.1 數(shù)據(jù)庫可視化
- ??導(dǎo)出數(shù)據(jù)庫??：使用 ADB 命令導(dǎo)出數(shù)據(jù)庫文件
- ??查看工具??：推薦使用 DB Browser for SQLite 等工具查看數(shù)據(jù)庫內(nèi)容
11.2 錯誤處理
完善的錯誤處理機制：
async function safeDatabaseOperation(operation) {
try {
return await operation()
} catch (error) {
console.error('數(shù)據(jù)庫操作失敗:', error)
// 記錄錯誤日志
// 根據(jù)錯誤類型進(jìn)行相應(yīng)處理
throw error
}
}十二、最佳實踐建議
- ??合理設(shè)計數(shù)據(jù)模型??：根據(jù)應(yīng)用需求設(shè)計合理的數(shù)據(jù)表結(jié)構(gòu)
- ??數(shù)據(jù)加密??：敏感數(shù)據(jù)應(yīng)進(jìn)行加密存儲
- ??版本管理??：實現(xiàn)數(shù)據(jù)庫版本升級機制
- ??備份恢復(fù)??：提供數(shù)據(jù)備份和恢復(fù)功能
- ??性能監(jiān)控??：監(jiān)控數(shù)據(jù)庫操作性能，及時發(fā)現(xiàn)性能瓶頸
總結(jié)
UniApp 集成 SQLite 數(shù)據(jù)庫為移動應(yīng)用提供了強大的本地數(shù)據(jù)存儲能力。通過本文介紹的完整流程，你可以實現(xiàn)從環(huán)境配置到高級功能的全面數(shù)據(jù)庫集成。在實際開發(fā)中，應(yīng)根據(jù)具體應(yīng)用場景選擇合適的技術(shù)方案，并遵循最佳實踐，確保數(shù)據(jù)操作的性能、安全性和穩(wěn)定性。
記住，良好的數(shù)據(jù)庫設(shè)計和管理是應(yīng)用成功的關(guān)鍵因素之一。合理利用 SQLite 的特性，可以為用戶提供流暢的離線體驗和高效的數(shù)據(jù)管理功能。
到此這篇關(guān)于UniApp集成SQLite數(shù)據(jù)庫的文章就介紹到這了,更多相關(guān)UniApp集成SQLite數(shù)據(jù)庫內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
SQLite3是輕量級嵌入式數(shù)據(jù)庫,無需服務(wù)器支持,具備ACID事務(wù)與跨平臺特性,適用于小型項目和學(xué)習(xí),sqlite3.exe作為命令行工具,支持SQL執(zhí)行、數(shù)據(jù)庫管理、數(shù)據(jù)導(dǎo)入導(dǎo)出及備份恢復(fù),提供高效的數(shù)據(jù)庫操作方式,本文給大家介紹SQLite3命令行工具實踐指南,感興趣的朋友一起看看吧2025-06-06
sqlite3一款主要用于嵌入式的輕量級數(shù)據(jù)庫，本文旨在為熟悉sqlite3基本命令提供技術(shù)文檔2013-12-12
SQLite是一款輕型的數(shù)據(jù)庫,它的設(shè)計目標(biāo)是嵌入式的,而且目前已經(jīng)在很多嵌入式產(chǎn)品中使用了它,下面這篇文章主要給大家介紹了關(guān)于SQLite3基本用法的相關(guān)資料,需要的朋友可以參考下2022-06-06
本文介紹了Linux下sqlite3的安裝、基本操作指令、SQL語句使用、C/C++?API調(diào)用及QT集成方法,涵蓋數(shù)據(jù)庫創(chuàng)建、表結(jié)構(gòu)定義、數(shù)據(jù)增刪改查、API執(zhí)行與回調(diào)機制等內(nèi)容,對linux?sqlite3使用感興趣的朋友一起看看吧2025-06-06
這篇文章主要介紹了SQLite3中自增主鍵相關(guān)知識總結(jié),清零的方法、INTEGER PRIMARY KEY AUTOINCREMENT和rowid的使用等,需要的朋友可以參考下2014-05-05
SQLite是一個軟件庫，實現(xiàn)了自給自足的、無服務(wù)器的、零配置的、事務(wù)性的 SQL 數(shù)據(jù)庫引擎。這篇文章主要介紹了CentOS下更新SQLite版本，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2021-12-12
這篇文章主要介紹了SQLite教程（十三）：C語言編程實例代碼（1）,本文講解了獲取表的Schema信息、動態(tài)創(chuàng)建表、刪除該表、常規(guī)數(shù)據(jù)插入、創(chuàng)建測試數(shù)據(jù)表、刪除測試表等內(nèi)容,需要的朋友可以參考下2015-05-05
這篇文章主要介紹了SQLite教程（二）：C/C++接口簡介,本文講解了C/C++接口概述、核心對象和接口、參數(shù)綁定等內(nèi)容,需要的朋友可以參考下2015-05-05
python之sqlalchemy創(chuàng)建表的實例詳解
這篇文章主要介紹了數(shù)據(jù)庫之sqlalchemy創(chuàng)建表的實例詳解的相關(guān)資料,希望通過本文能幫助到大家，讓大家掌握理解這部分內(nèi)容，需要的朋友可以參考下2017-10-10
SQLite是一個輕量級的嵌入式數(shù)據(jù)庫引擎,廣泛應(yīng)用于 C++ 項目中,它支持兩種主要的數(shù)據(jù)存儲模式,內(nèi)存模式和持久化文件模式,這篇文章主要介紹了一次Sqlite使用問題的相關(guān)資料,需要的朋友可以參考下2026-01-01