Android老项目中Room数据库插入数据丢失问题求助

一、先锁定核心问题：插入是否真的失败，还是数据库文件读取有误 #

1. 用代码验证数据量：插入完成后立即调用Room的查询接口（比如@Query("SELECT COUNT(*) FROM your_table")），打印返回的条数。如果代码里查询是75条，但SQLite Browser里显示少，那问题出在数据库文件的读取上，不是插入逻辑。
2. 正确获取数据库文件：Room默认用WAL模式，主数据库文件（xxx.db）会和xxx.db-wal、xxx.db-shm配套存在。直接复制xxx.db会导致未提交的WAL日志数据丢失，要先做以下操作再复制：
   • 关闭数据库连接：调用yourDatabase.close()
   • 或者执行SQL强制合并日志：yourDatabase.runInTransaction(() -> yourDatabase.query("PRAGMA wal_checkpoint(FULL)"))

二、关于Room的字段唯一性检查 #

Room只会对标记了@PrimaryKey或@Unique注解的字段做唯一性约束，其他字段默认不会检查。如果你的主键确实唯一，那插入冲突（比如OnConflictStrategy）不会触发，这说明数据丢失和冲突处理无关。

三、排查RxJava与前台服务的生命周期问题 #

1. 服务停止时机是否过早：你在CompletableObserver.onComplete()里停止服务，但要确保Room的插入操作真的完成了。RxJava的异步订阅可能存在回调触发但事务未提交的情况——比如用了subscribeOn(Schedulers.io())但没有同步等待事务结束。建议在插入的Completable链最后加上observeOn(AndroidSchedulers.mainThread())，确保服务停止在主线程执行，且等待插入事务完全结束。
2. 防止Rx订阅被意外取消：检查前台服务的onDestroy是否在插入过程中被触发，或者Rx的Disposable是否被提前dispose。可以把Disposable存在服务的成员变量里，在onDestroy里手动取消，但插入过程中不要调用。

四、优化插入逻辑的可靠性 #

1. 用批量插入替代逐条循环：Room的@Insert支持直接传入List<YourEntity>，默认会把整个批量操作放在一个事务里，不仅效率更高，也能避免逐条插入时的事务提交问题。同时，批量插入会返回List<Long>，每个元素对应一条数据的插入结果，-1表示插入失败，打印这个列表就能明确看到哪些数据没插进去。
2. 开启Room查询日志：通过日志查看实际执行的SQL语句，确认插入的数据是否正确：

   Room.databaseBuilder(context, YourDb.class, "your_db")
       .setQueryCallback((sql, args) -> Log.d("RoomDebug", String.format("%s, args: %s", sql, args)), Executors.newSingleThreadExecutor())
       .build();
   

五、其他排查细节 #

• 检查实体类字段映射：有没有字段类型不匹配（比如数据库是TEXT，实体类是Integer）、或者用@Ignore误标记了必要字段？Room的类型转换错误可能不会抛出异常，但会导致插入失败。
• 验证数据转换：把JSON转成实体类列表后，遍历打印所有实体的字段，确认和JSON里的数据完全一致，排除转换过程中的数据丢失。

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