是否必须将Room的DAO中函数定义为suspend函数？

我正在使用Room开发一款简单应用，已创建如下代码：

DAO接口 #

interface ItemDao {
    @Insert(onConflict = IGNORE)
    fun addItem(item: Item)
}

仓库接口 #

interface ItemRepository {
    fun addItem(item: Item)
}

仓库实现类 #

class ItemRepositoryImpl(
    private val itemDao: ItemDao
) : ItemRepository {
    override fun addItem(item: Item) = itemDao.addItem(item)
}

ViewModel类 #

class ItemViewModel @Inject constructor(
    private val repo: ItemRepository
) : ViewModel() {
    fun addItem(item: Item) = viewModelScope.launch(Dispatchers.IO) {
        repo.addItem(item)
    }
}

数据库实例创建方式 #

fun provideItemDb(
    @ApplicationContext
    context : Context
) = Room.databaseBuilder(
    context,
    ItemDb::class.java,
    "item_table"
).build()

从UI调用addItem时，数据可成功存入Room。现在我有个疑问：是否必须将ItemDao中的addItem函数定义为suspend函数？如果是，原因是什么？

回答 #

并非强制要求，但强烈建议将DAO中的addItem定义为suspend函数，原因如下：

1. 规避主线程操作风险
   Room默认禁止在主线程执行数据库操作，你当前代码能正常运行，是因为手动通过viewModelScope.launch(Dispatchers.IO)把调用放到了IO线程。但如果后续不小心修改了协程调度器（比如改成Dispatchers.Main），直接调用非suspend的DAO函数会立刻抛出IllegalStateException。而定义成suspend函数后，Room会自动确保该函数在后台线程执行，就算在主线程协程中调用也不会崩溃，从底层规避了线程错误。

2. 契合协程异步范式
   你的ViewModel已经使用协程处理异步逻辑，DAO层定义为suspend函数能让整个调用链的异步语义更清晰。仓库层也可以同步改为suspend函数，让代码逻辑保持统一，其他开发者一眼就能识别这是耗时操作，必须在协程上下文中调用。

3. 避免UI阻塞与隐性bug
   如果后续扩展DAO的查询功能，非suspend的查询函数若误在主线程调用，会直接阻塞UI导致卡顿，这类问题很难排查。统一使用suspend函数能从编码层面强制开发者用协程处理，符合Android异步操作的最佳实践，减少潜在的隐性bug。

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