重命名Java实体类后Room SQL查询报错，求解决方案

错误信息 #

1. 类型转换异常：

error: Not sure how to convert a Cursor to this method's return type 
(java.util.List<com.example.c196_studentapp.Entity.assessmentEntity>)

2. 表不存在错误：

error: There is a problem with the query: [SQLITE_ERROR] SQL error or 
missing database (no such table: assessmentEntity)

核心问题分析 #

1. 表名不匹配：实体类assessmentEntity通过@Entity(tableName = "assessment_table")指定了数据库表名为assessment_table，但DAO中的所有@Query语句都错误地使用assessmentEntity作为表名，导致SQLite找不到对应表。
2. 第一个错误是第二个错误的连锁反应：因查询的表不存在，返回的Cursor无法正确映射到实体类，进而抛出类型转换异常。

解决步骤 #

1. 修正DAO中的SQL表名 #

将assessmentDAO里所有SQL语句中的assessmentEntity替换为assessment_table：

@Dao
public interface assessmentDAO {
    @Insert(onConflict = OnConflictStrategy.IGNORE)
    public void insert(assessmentEntity assessment);

    @Update
    public void update(assessmentEntity assessment);

    @Delete
    public void delete(assessmentEntity assessment);

    @Query("DELETE FROM assessment_table")
    public void deleteAllAssessments();

    @Query("SELECT * FROM assessment_table ORDER BY assessmentID ASC")
    List<assessmentEntity> getAllAssessments();
}

2. 清理并重建数据库（关键） #

重命名实体类后，Room的数据库schema可能存在缓存，即使改回原名也会残留旧结构，需执行以下操作：

• 卸载当前应用并清除应用数据
• 或在Room数据库类中添加fallbackToDestructiveMigration()强制重建数据库（仅开发阶段使用，会丢失现有数据）：

@Database(entities = {assessmentEntity.class, ...}, version = 2)
public abstract class AppDatabase extends RoomDatabase {
    public static AppDatabase getInstance(Context context) {
        return Room.databaseBuilder(context, AppDatabase.class, "app_database")
                .fallbackToDestructiveMigration()
                .build();
    }
}

3. 检查实体类完整性（可选） #

确认实体类所有字段都有对应的getter方法，构造函数包含所有需要持久化的字段。当前assessmentEntity的构造函数与getter/setter配置正常，无需调整。

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