如何解决使用Room数据库的Android应用访问时崩溃问题？

核心崩溃原因 #

应用崩溃的核心原因有两个：一是Room无法直接序列化Calendar和Duration这类自定义类型，必须提供类型转换器；二是Kotlin项目中Room编译器依赖配置错误，导致注解处理失效。

修复步骤 #

1. 修正Room编译器依赖配置

你的项目是Kotlin工程，当前使用的annotationProcessor不适用于Kotlin注解处理，需替换为kapt并添加对应插件：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-kapt") // 新增kapt插件
}

// 保留原有android配置...

dependencies {
    // 保留原有依赖...

    val room_version ="2.5.2"
    implementation("androidx.room:room-runtime:$room_version")
    kapt("androidx.room:room-compiler:$room_version") // 替换annotationProcessor为kapt
    implementation("androidx.room:room-ktx:$room_version") // 可选，添加Room Kotlin扩展支持
}

2. 添加TypeConverter处理自定义类型

创建Converters类，实现Calendar、Duration与Room支持的基本类型的双向转换：

package com.dmlpcb.familiar.data

import androidx.room.TypeConverter
import java.time.Duration
import java.util.Calendar

class Converters {
    // Calendar ↔ Long（存储时间戳）
    @TypeConverter
    fun fromCalendar(calendar: Calendar?): Long? {
        return calendar?.timeInMillis
    }

    @TypeConverter
    fun toCalendar(timestamp: Long?): Calendar? {
        return timestamp?.let {
            Calendar.getInstance().apply { timeInMillis = it }
        }
    }

    // Duration ↔ Long（存储秒数）
    @TypeConverter
    fun fromDuration(duration: Duration?): Long? {
        return duration?.seconds
    }

    @TypeConverter
    fun toDuration(seconds: Long?): Duration? {
        return seconds?.let { Duration.ofSeconds(it) }
    }
}

在AppDatabase类上添加注解，让Room识别这些转换器：

@Database(entities = [Notice::class, CalendarEvent::class], version = 1, exportSchema = false)
@TypeConverters(Converters::class) // 新增此注解
abstract class AppDatabase: RoomDatabase() {
    // 保留原有代码...
}

3. 优化实体类与Dao（可选但推荐）

• 明确指定表名，避免默认命名规则的潜在问题：

@Entity(tableName = "calendar_events")
data class CalendarEvent(
    // 保留原有字段...
)

@Entity(tableName = "notices")
data class Notice(
    // 保留原有字段...
)

• 同步修改Dao中的查询语句，确保表名一致：

@Dao
interface CalendarEventDao {
    @Query("SELECT * FROM calendar_events")
    fun getAll(): List<CalendarEvent>
    // 保留其他方法...
}

4. 主线程访问优化（可选）

虽然你开启了allowMainThreadQueries()，但生产环境中容易引发ANR，建议将Dao方法改为suspend函数，配合协程使用：

@Dao
interface CalendarEventDao {
    @Query("SELECT * FROM calendar_events")
    suspend fun getAll(): List<CalendarEvent>

    @Insert
    suspend fun insertAll(vararg calendarEvents: CalendarEvent)

    @Delete
    suspend fun delete(calendarEvent: CalendarEvent)
}

在Activity中通过协程调用：

lifecycleScope.launch {
    val events = AppDatabase.getInstance(this@MainActivity).calendarEventDao().getAll()
    // 处理查询结果
}

之后可移除allowMainThreadQueries()，遵循Room最佳实践。

验证修复 #

1. 执行Clean Project -> Rebuild Project清理并重建项目
2. 运行应用测试数据库操作，崩溃问题应该已解决

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