Android Room重装应用时清空数据库并重置自增主键方法

问题根源 #

Room底层依赖SQLite，当给实体类设置@PrimaryKey(autoGenerate = true)时，SQLite会通过sqlite_sequence系统表记录该表自增主键的当前最大值。哪怕删除了目标表的所有数据，只要sqlite_sequence里的记录没清空，下次插入数据时主键会从之前的最大值继续递增。另外仅设置android:allowBackup="false"可能不够，部分系统或调试场景下数据库文件仍可能被保留。

具体解决方案 #

1. 重置SQLite自增序列记录

在Dao接口中添加专门的SQL语句，清空对应表的自增序列记录：

@Dao
interface MyEntityDao {
    // 清空目标表所有数据
    @Query("DELETE FROM MyEntity")
    fun clearMyEntity()

    // 重置目标表的自增主键序列
    @Query("DELETE FROM sqlite_sequence WHERE name = 'MyEntity'")
    fun resetMyEntityPrimaryKey()
}

在需要重置的时机（比如APP首次启动、重装后初始化流程中），先调用clearMyEntity()清空数据，再调用resetMyEntityPrimaryKey()重置主键序列。如果要重置所有表的主键，可改用：

@Query("DELETE FROM sqlite_sequence")
fun resetAllPrimaryKeys()

2. 彻底关闭系统备份

在AndroidManifest.xml的<application>标签中同时设置两个属性，确保系统不备份应用数据：

<application
    ...
    android:allowBackup="false"
    android:fullBackupContent="false">

fullBackupContent是Android 8.0+新增的属性，设置为false可禁止Auto Backup机制备份应用数据。

3. 调试时手动清理数据库文件

在Android Studio的Device File Explorer中，找到路径/data/data/你的应用包名/databases/，删除其中的.db、.db-shm、.db-wal三类文件，再重装应用，确保数据库文件被完全删除。

注意点 #

SQLite的自增主键默认从1开始，而非0。如果你实体类中主键初始值设为0，插入后返回的主键会是1，这属于正常现象。

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