鸿蒙应用本地数据库导出与查看指南

一、导出方法（推荐3种）

方法1：DevEco Studio可视化导出（开发调试首选）

在IDE右侧打开 Device File Browser
导航至数据库路径：/data/storage/el2/database/entry/rdb/
同时选中以下三个文件：
- 数据库名.db
- 数据库名.db-wal
- 数据库名.db-shm
右键选择 Save As → 保存到本地文件夹

方法2：使用hdc命令行工具

bash

perl 复制代码

# 连接设备
hdc shell

# 查找数据库路径
find /data -name "数据库名.db"

# 退出shell后导出文件
hdc file recv /沙箱路径/数据库名.db 本地路径
hdc file recv /沙箱路径/数据库名.db-wal 本地路径
hdc file recv /沙箱路径/数据库名.db-shm 本地路径

方法3：代码实现导出（应用内功能）

typescript

javascript 复制代码

import picker from '@ohos.file.picker';

// 备份数据库
async backupDatabase() {
    const dbBackupPath = this.context.databaseDir + '/backup.db';
    await this.rdbStore.backup(dbBackupPath);
    return dbBackupPath;
}

// 导出到用户设备
async exportDatabase() {
    const backupPath = await this.backupDatabase();
    const filePicker = new picker.DocumentViewPicker();
    const targetUri = await filePicker.save({newFileNames: ['backup.db']});
    await fs.copyFile(backupPath, targetUri[0]);
}

二、查看数据库内容

必备条件

三个文件必须保持在同一目录
文件名必须保持原始名称
使用支持WAL模式的工具（推荐SQLiteStudio）

查看步骤（SQLiteStudio）

下载安装 SQLiteStudio
打开软件 → Database → Add a database
选择导出的 .db 文件
关键设置 ：勾选 Use WAL mode (Write-Ahead Logging)
双击左侧数据库连接 → 展开Tables查看数据表
右键表名 → Edit table 查看数据

sqlitestudio.pl/images/scre...

三、常见问题解决

问题现象	原因	解决方案
看不到最新数据	WAL文件未正确处理	1. 确认三个文件在同一目录 2. 执行SQL命令：`PRAGMA journal_mode=DELETE;`
"database disk image is malformed"	文件导出不完整	1. 重新导出三个文件 2. 使用代码备份后导出单个backup.db文件
加密数据库无法打开	缺少密钥	1. 代码中配置加密密钥 2. 在SQLiteStudio中选择SQLCipher标签输入密钥
导出文件权限不足	未声明文件权限	在module.json5中添加： `"requestPermissions": [{ "name": "ohos.permission.FILE_ACCESS_PERSISTED" }]`

四、高级技巧

命令行查看（需安装SQLite3）

bash

sql 复制代码

sqlite3 数据库名.db

-- 合并WAL文件
PRAGMA wal_checkpoint(FULL);

-- 查看所有表
.tables

-- 查询数据
SELECT * FROM 表名;

导出为JSON（代码实现）

typescript

typescript 复制代码

async exportToJSON(tableName: string) {
    const data = await this.rdbStore.query(`SELECT * FROM ${tableName}`);
    const jsonStr = JSON.stringify(data);
    
    const filePicker = new picker.DocumentViewPicker();
    const uri = await filePicker.save({
        newFileNames: [`${tableName}.json`]
    });
    
    await fs.writeText(uri[0], jsonStr);
}

五、注意事项

必须同时导出三个文件（.db、.db-wal、.db-shm）
开发阶段优先使用DevEco Studio导出