安卓开发：如何将Room数据库存储或共享为单个文件？

当然可以将Room数据库转为单个文件存储或共享。你看到的三个文件（database_name、database_name-wal、database_name-shm）是因为Room默认启用了SQLite的WAL（Write-Ahead Logging）日志模式，这是一种提升读写性能的机制，并非永久固定的状态。

方法一：永久切换为单文件模式（关闭WAL） #

Room支持通过注解配置SQLite的日志模式，将其改为DELETE模式后，数据库就只会生成单个主文件，不会再产生-wal和-shm文件。

配置示例 #

Kotlin代码：

@Database(
    entities = [YourEntity::class],
    version = 1,
    journalMode = JournalMode.DELETE
)
abstract class AppDatabase : RoomDatabase() {
    // 声明你的DAO
    abstract fun yourDao(): YourDao
}

Java代码：

@Database(entities = {YourEntity.class}, version = 1, journalMode = JournalMode.DELETE)
public abstract class AppDatabase extends RoomDatabase {
    // 声明你的DAO
    public abstract YourDao yourDao();
}

注意事项 #

• WAL模式的写性能（尤其是并发写入）远优于DELETE模式，如果你应用的读写操作频繁，切换前需要权衡性能损失。
• 切换模式后，旧的-wal和-shm文件会在数据库打开时被自动清理。

方法二：临时合并为单文件（保留WAL模式） #

如果不想牺牲WAL模式的性能，只是需要临时生成单个文件用于共享，可以通过SQLite的检查点命令将WAL日志合并到主数据库，之后关闭连接即可自动删除额外文件。

操作步骤 #

1. 获取Room数据库实例，执行检查点命令：

val db = AppDatabase.getInstance(applicationContext)
// 执行全量检查点，将WAL日志合并到主数据库
db.openHelper.writableDatabase.execSQL("PRAGMA wal_checkpoint(FULL)")
// 必须关闭数据库，否则-wal和-shm文件不会被删除
db.close()

2. 此时你的数据库目录下只会剩下database_name单个文件，即可安全共享。

注意事项 #

• 执行操作时确保没有其他进程/线程正在使用该数据库，否则可能导致数据不一致或文件无法清理。
• 共享完成后，重新打开数据库时，Room会自动恢复WAL模式，重新生成-wal和-shm文件。

额外提示 #

• 跨应用共享数据库时，不建议直接传递文件（容易出现权限问题或文件损坏），优先考虑使用ContentProvider提供数据访问接口。
• 如果要将文件保存到外部存储供其他应用访问，需要申请对应存储权限（Android 10及以上可使用Scoped Storage）。

内容的提问来源于stack exchange，提问作者Estripper