room 无法自动将 join 查询中来自关联表的字段映射到实体类成员，需通过 sql 别名（as）显式指定列名与 java 字段名一致，否则生成的 dao 实现会忽略该字段并传入 null。
room 无法自动将 join 查询中来自关联表的字段映射到实体类成员，需通过 sql 别名（as）显式指定列名与 java 字段名一致，否则生成的 dao 实现会忽略该字段并传入 null。
在使用 Room 执行多表 JOIN 查询时，若目标实体类（如 Bottle）包含非主表字段（例如 ingredientName 来自 ingredient_types.name），Room 的编译期代码生成器不会自动推断字段来源——它仅依据 SQL 查询结果集中列的名称 与实体类字段名进行严格匹配。
观察你提供的生成代码：
_result = new Bottle(_tmpPosition, _tmpName, _tmpCapacity, _tmpCurrentAmount, null);
最后一项为 null，正是因为原始 SQL 中 it.name 未设置别名，查询结果集的第五列名为 name（而非 ingredientName），Room 无法将其绑定到 Bottle.ingredientName 字段。
✅ 正确做法是：为 JOIN 查询中需要映射的字段显式添加 AS 别名，使其与 Java 字段名完全一致：
@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);
⚠️ 注意事项：
- 别名必须严格区分大小写，且与 Java 字段名（如 ingredientName）完全一致；
- 不要依赖下划线命名（如 ingredient_name）或驼峰不匹配（如 ingredientname），Room 不做任何转换；
- 若 Bottle 类中存在其他未在查询中 SELECT 的字段，其值将保持默认（如 int 为 0，String 为 null），Room 不会报错但可能引发逻辑隐患；
- 建议配合 @ColumnInfo(name = "...") 在字段上声明映射（虽本例非必需，但可提升可维护性）；
- 编译后务必检查生成的 *_Impl.java 文件，确认 _cursor 索引是否覆盖全部字段（如 final int _cursorIndexOfIngredientName = 4;）。
? 进阶提示：对于复杂 JOIN 结果，推荐使用 @Embedded + @Relation 或定义专用 POJO（如 BottleWithIngredient），避免字段名冲突和映射歧义；但对简单投影场景，AS 别名是最轻量、最可靠的解决方案。
