Room DAO查询报错：Metric实体缺失date/temp字段求助（Android天气APP）

一、MetricSimpleFutureWeatherEntry 列缺失问题 #

这个错误的核心是Room查询返回的列与实体类字段不匹配，按以下步骤排查修复：

1. 检查实体类映射
   确保MetricSimpleFutureWeatherEntry的字段与数据库表列一一对应，字段名不一致时需用@ColumnInfo指定列名：

@Entity(tableName = "future_weather")
data class MetricSimpleFutureWeatherEntry(
    @PrimaryKey
    @ColumnInfo(name = "date") // 明确映射表中date列
    val date: Long,
    @ColumnInfo(name = "temp") // 明确映射表中temp列
    val temp: Double,
    // 其他字段...
)

2. 修正DAO查询语句
   查询必须包含实体类的所有必填字段，避免漏选或错选列：

@Dao
interface FutureWeatherDao {
    // 要么显式指定所有需返回的列
    @Query("SELECT date, temp, [其他字段] FROM future_weather WHERE city_id = :cityId")
    suspend fun getFutureWeather(cityId: Int): List<MetricSimpleFutureWeatherEntry>
    
    // 要么用SELECT *（前提是表结构和实体类字段完全匹配）
    @Query("SELECT * FROM future_weather WHERE city_id = :cityId")
    suspend fun getFutureWeather(cityId: Int): List<MetricSimpleFutureWeatherEntry>
}

3. 验证数据库表结构
   如果是新增的date/temp字段，需确认数据库表已同步创建对应列：

• 测试阶段可卸载重装APP，让Room重新生成表
• 正式环境需编写Room迁移代码，避免数据丢失

二、CurrentWeatherDao 查询报错通用修复 #

根据Room常见报错场景，按以下方向排查：

1. 检查查询语句正确性
   确认表名、列名、查询条件拼写无误：

@Dao
interface CurrentWeatherDao {
    @Query("SELECT * FROM current_weather WHERE city_id = :cityId") // 表名、列名需与实体类/数据库一致
    suspend fun getCurrentWeather(cityId: Int): CurrentWeatherEntry?
}

2. 确认方法返回类型匹配

• 配合Coroutines的方法必须加suspend注解
• 返回单个实体时用?标记可空，避免无数据时报错
• 批量查询返回List<实体类>

3. 检查实体类主键与插入策略
   如果是插入/更新报错，需确认主键冲突处理策略：

@Insert(onConflict = OnConflictStrategy.REPLACE) // 重复主键时替换旧数据
suspend fun insertCurrentWeather(weather: CurrentWeatherEntry)

4. 查看Logcat详细错误
   Room会在Logcat输出具体报错原因（比如列名不匹配、返回类型错误），根据提示精准修复。

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