Android Room 中无法在主线程上访问数据库错误的解决方法和最佳实践

2024-03-25 23:02:44

在 Android Room 中解决“无法在主线程上访问数据库”错误

简介

Android Room 是一个强大的 ORM（对象关系映射）框架，可以简化 Android 中数据库交互。然而，在使用 Room DAO 运行查询时，你可能会遇到 "无法在主线程上访问数据库" 错误。这是因为 Room 要求在后台线程中执行数据库操作，以避免阻塞主线程并导致 UI 冻结。

解决方法

1. 使用 @DatabaseThread 注解

在 DAO 方法中添加 @DatabaseThread 注解，Room 会自动在后台线程中执行查询。

@Dao
public interface AgentDao {

    @DatabaseThread
    @Query("SELECT COUNT(*) FROM Agent where email = :email OR phone = :phone OR licence = :licence")
    int agentsCount(String email, String phone, String licence);

    @Insert
    void insertAgent(Agent agent);
}

2. 使用 RxJava2

Room 支持 RxJava2，允许你在后台线程中执行查询。

@Dao
public interface AgentDao {

    @Query("SELECT COUNT(*) FROM Agent where email = :email OR phone = :phone OR licence = :licence")
    Single<Integer> agentsCount(String email, String phone, String licence);

    @Insert
    Completable insertAgent(Agent agent);
}

3. 使用异步任务或后台服务

如果你不想使用 Room 的内置异步支持，你可以创建异步任务或后台服务来执行查询。这将确保查询在后台线程中运行。

其他建议