Android Room子查询字段匹配失败：无法绑定main_game至实体属性

核心问题原因 #

1. 注解冲突：@Ignore 和 @ColumnInfo 同时使用完全矛盾——@Ignore 会告诉Room忽略该字段，不参与任何数据库映射，自然无法绑定查询结果的main_game别名；而@ColumnInfo是指定字段与数据库列的映射关系，两者不能共存。
2. 构造器/类型匹配问题：要么构造器参数与查询返回的所有列（包括子查询的main_game）不匹配，要么子查询返回的_id类型与mainGame字段类型不兼容（比如_id是Integer但字段定义为String）。

具体修复步骤 #

1. 修正实体类的字段注解

移除mainGame上的@Ignore，保留@ColumnInfo（或依赖Room的驼峰转下划线自动匹配），确保Room能识别该字段并绑定查询结果：

@Entity(tableName = "games")
public class GameEntity extends GenericIndexEntity {
    @NonNull
    @ColumnInfo(name = "gen")
    private Integer gen;
    @NonNull
    @ColumnInfo(name = "is_main")
    private Integer isMain;
    // 去掉@Ignore，用@ColumnInfo明确绑定查询别名main_game
    @ColumnInfo(name = "main_game")
    private String mainGame; // 注意：如果_id是Integer类型，这里要改成Integer

    // 主构造器：确保参数覆盖所有查询返回的列（包括父类字段）
    public GameEntity(@NonNull String indexNumber, String name, String nameEs, String nameIt, String nameFr, String nameDe, String namePt, String nameRu, @NonNull Integer gen, @NonNull Integer isMain, String mainGame) {
        super(indexNumber, name, nameEs, nameIt, nameFr, nameDe, namePt, nameRu);
        this.gen = gen;
        this.isMain = isMain;
        this.mainGame = mainGame;
    }

    // 添加Room可用的无参构造器（用@Ignore避免影响业务逻辑）
    @Ignore
    public GameEntity() {
        super();
    }

    // 省略getter、setter
}

2. 优化查询语句（可选但推荐）

避免使用SELECT *，明确列出所有返回列，确保与构造器参数顺序/类型完全匹配，减少列顺序不匹配的风险：

@Dao
public interface GamesDao {
    @Query("SELECT " +
            "g._id, g.index_number, g.name, g.name_es, g.name_it, " +
            "g.name_fr, g.name_de, g.name_pt, g.name_ru, g.gen, g.is_main, " +
            "(SELECT g_nested._id FROM games as g_nested, game_groups as gg WHERE g_nested._id = gg._game_group AND g_nested.is_main = 1 AND gg._game = g._id) as main_game " +
            "FROM games as g")
    List<GameEntity> getAll();
}

3. 验证子查询返回类型

检查games表的_id类型：如果是Integer，需将mainGame字段类型改为Integer，否则会因类型不匹配导致绑定失败。

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