Room 无法自动将 SQL 查询结果中的列名映射到实体类非标准字段（如 ingredientName），必须通过 AS 显式指定列别名，否则生成的 DAO 实现会忽略该字段并传入 null。
room 无法自动将 sql 查询结果中的列名映射到实体类非标准字段（如 `ingredientname`），必须通过 `as` 显式指定列别名，否则生成的 dao 实现会忽略该字段并传入 `null`。
在使用 Room 构建数据库访问层时，DAO 接口中的 @Query 方法返回自定义 POJO（如 Bottle 类）时，Room 依赖列名与字段名严格匹配来完成自动映射。你当前的查询：
SELECT b.position,b.name,b.capacity,b.currentAmount, it.name FROM bottles AS b INNER JOIN bottle_ingredient AS bi ON bi.bottlePos=b.position INNER JOIN ingredient_types AS it ON it.id=bi.ingredientId WHERE position = :position
虽然能正确执行并返回 5 列数据（包括 it.name），但 Room 生成的实现代码中，第 5 列（即 it.name）并未被读取赋值给 ingredientName 字段——原因在于：Room 只识别结果集中列名（column name）是否与 Java 字段名一致，而原始查询中该列为 name（来自 it.name），与 Bottle.ingredientName 不匹配，因此被跳过，构造器中直接传入 null。
✅ 正确做法是为该列添加别名，使其名称与目标字段完全一致：
@Query("SELECT b.position, b.name, b.capacity, b.currentAmount, it.name AS ingredientName " +
"FROM bottles AS b " +
"INNER JOIN bottle_ingredient AS bi ON bi.bottlePos = b.position " +
"INNER JOIN ingredient_types AS it ON it.id = bi.ingredientId " +
"WHERE b.position = :position")
Bottle getBottleWithIngredientFromPosition(int position);
? 关键点：it.name AS ingredientName —— AS 子句显式将查询列重命名为 ingredientName，Room 编译器即可在生成代码中识别并绑定该值。
? 补充说明与最佳实践：
- Room 不支持基于字段顺序的隐式映射（如“第 5 列 → 第 5 个构造参数”），仅支持列名 → 字段名的精确匹配；
- 若 Bottle 类使用 @Embedded 或 @Relation，应优先考虑用 @Relation 管理一对多/多对一关联，而非手动拼接 JOIN 查询；
- 所有用于映射的列名（含别名）区分大小写，需确保与 Java 字段名（驼峰命名）完全一致；
- 建议开启 Room 编译时检查：在 build.gradle 中添加 android.useAndroidX=true 和 kapt { arguments { arg("room.schemaDirectory", "$projectDir/schemas") } }，配合 @Database(exportSchema = true) 可捕获潜在映射问题。
修正后，Room 将生成包含完整字段读取逻辑的 DAO 实现，例如：
// ...（前面字段读取不变）
final String _tmpIngredientName;
if (_cursor.isNull(4)) {
_tmpIngredientName = null;
} else {
_tmpIngredientName = _cursor.getString(4); // ✅ 现在读取第 5 列（索引 4）
}
_result = new Bottle(_tmpPosition, _tmpName, _tmpCapacity, _tmpCurrentAmount, _tmpIngredientName);
至此，ingredientName 将被正确填充，不再为 null。
