room 无法自动将 join 查询结果中的列名与实体类字段匹配时，需通过 sql 别名（as）显式指定字段映射关系，否则 room 生成的 dao 实现会忽略未匹配字段并设为 null。
room 无法自动将 join 查询结果中的列名与实体类字段匹配时，需通过 sql 别名（as）显式指定字段映射关系，否则 room 生成的 dao 实现会忽略未匹配字段并设为 null。
在使用 Room 执行多表 JOIN 查询并返回自定义 POJO（如 Bottle）时，Room 的编译时代码生成器依赖列名与 POJO 字段名的精确匹配来完成数据绑定。你当前的查询：
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 生成的 Cursor 解析逻辑仅识别前 4 列对应 Bottle 的 position、name、capacity、currentAmount，而第 5 列原始列名为 name（来自 ingredient_types 表），与 Bottle.ingredientName 字段名不一致，因此 Room 跳过该列解析，直接传入 null 构造对象。
✅ 正确做法是：为 JOIN 中的字段显式添加 AS 别名，使其与目标 POJO 字段名完全一致。修改你的 @Query 如下：
@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 —— 显式将 ingredient_types.name 列重命名为 ingredientName；
- WHERE b.position = :position —— 建议为 position 加表别名前缀（如 b.position），避免歧义（尤其当多表存在同名列时）；
- Room 编译器将据此识别第 5 列名为 ingredientName，并在生成代码中调用 _cursor.getString(_cursorIndexOfIngredientName) 并传入构造函数。
? 验证建议：
- 清理项目（Build → Clean Project）后重新构建，确保 Bottle_Impl 类被重新生成；
- 检查生成代码中是否出现类似 final int _cursorIndexOfIngredientName = 4; 及对应 _cursor.getString(...) 调用；
- 若仍为 null，请确认 it.name 在数据库中确实非空（可通过 Database Inspector 或导出 DB 验证）。
? 补充说明：
Room 不支持基于字段类型或注解（如 @ColumnInfo(name = "...")）对 JOIN 查询结果做字段映射推导——它只认 SQL 返回的列名。因此，对于任何非主表字段的映射，AS 别名是必须且最可靠的方案。若需更灵活的映射（如嵌套对象），可考虑使用 @Embedded + @Relation 组合，但 JOIN 查询场景下，别名始终是首选实践。
