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

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

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

1. 在IDE右侧打开 Device File Browser

2. 导航至数据库路径：/data/storage/el2/database/entry/rdb/

3. 同时选中以下三个文件：

   • 数据库名.db
   • 数据库名.db-wal
   • 数据库名.db-shm

4. 右键选择 Save As → 保存到本地文件夹

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

bash

# 连接设备 hdc shell # 查找数据库路径 find /data -name "数据库名.db" # 退出shell后导出文件 hdc file recv /沙箱路径/数据库名.db 本地路径 hdc file recv /沙箱路径/数据库名.db-wal 本地路径 hdc file recv /沙箱路径/数据库名.db-shm 本地路径

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

typescript

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]); }

二、查看数据库内容

必备条件

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

查看步骤（SQLiteStudio）

1. 下载安装 SQLiteStudio
2. 打开软件 → Database → Add a database
3. 选择导出的 .db 文件
4. 关键设置：勾选 Use WAL mode (Write-Ahead Logging)
5. 双击左侧数据库连接 → 展开Tables查看数据表
6. 右键表名 → 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

sqlite3 数据库名.db -- 合并WAL文件 PRAGMA wal_checkpoint(FULL); -- 查看所有表 .tables -- 查询数据 SELECT * FROM 表名;

导出为JSON（代码实现）

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); }

五、注意事项

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