Room框架DAO实现生成异常：查询返回对象字段为null问题排查

以下是针对你遇到的Bottle对象ingredientName字段始终为null问题的排查方向和解决办法：

• 检查SQL查询的列名映射
  Room生成DAO实现时，会严格匹配查询结果列名与实体类字段名。如果你的关联查询中，ingredientName对应的列没有使用和实体类字段完全一致的名称（包括大小写），Room会无法识别该列，导致构造对象时传入null。
  解决：给查询结果列添加别名，确保和实体类字段名一致，示例SQL：

  SELECT b.id, b.bottle_name, i.name AS ingredientName 
  FROM bottle b 
  INNER JOIN ingredient i ON b.ingredient_id = i.id
  

• 验证实体类字段的Room注解
  若Bottle类中的ingredientName字段未被正确标记为Room可识别的持久化字段，比如遗漏@ColumnInfo注解（当列名与字段名不同时），或被错误添加@Ignore注解，Room会忽略该字段，生成代码时不会从游标读取对应值。
  示例正确的实体类定义：

  @Entity(tableName = "bottle")
  data class Bottle(
      @PrimaryKey val id: Int,
      @ColumnInfo(name = "bottle_name") val bottleName: String,
      @ColumnInfo(name = "ingredientName") val ingredientName: String?
  )
  

• 确认构造函数的匹配性
  Room会优先选择实体类中参数与查询结果列匹配的构造函数。如果Bottle类存在多个构造函数，且Room选中的构造函数不包含ingredientName参数，就会导致该字段为null。
  解决：确保目标构造函数包含所有需要的字段，或用@Ignore标记不需要Room使用的构造函数：

  data class Bottle(
      val id: Int,
      val bottleName: String,
      val ingredientName: String?
  ) {
      // 标记该构造函数为Room忽略
      @Ignore
      constructor(id: Int, bottleName: String) : this(id, bottleName, null)
  }
  

• 清理构建缓存
  有时Room注解处理器的缓存会导致生成的DAO代码未同步更新，即使你修改了SQL或实体类。
  解决：执行项目清理与重建操作，比如在Android Studio中选择Build > Clean Project，再执行Build > Rebuild Project，或手动删除项目的build目录后重新构建。

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