Android Room复合主键场景下更新失效，如何解决？

问题场景 #

使用Android Room操作带有复合主键（groupFK、readingFK、responsoryFK）的数据表时，通过DAO的@Update方法传入LHOfficeBiblicalTable列表执行更新操作无效果；手动修改readingFK值后更新可成功，排除外键约束问题，非复合主键实体更新正常，确认问题与复合主键的匹配逻辑相关。

相关代码 #

实体类定义 #

@Entity(tableName = LH_OFFICE_BIBLICAL,
        primaryKeys = {"groupFK","readingFK","responsoryFK"},
        foreignKeys = {
           @ForeignKey(
                   entity = LHOfficeBiblicalJoinEntity.class,
                   parentColumns = "groupID",
                   childColumns = "groupFK",
                   onDelete = ForeignKey.CASCADE,
                   onUpdate = ForeignKey.CASCADE),
            @ForeignKey(
                    entity = BibleReadingEntity.class,
                    parentColumns = "readingID",
                    childColumns = "readingFK",
                    onDelete = ForeignKey.CASCADE,
                    onUpdate = ForeignKey.CASCADE),
            @ForeignKey(
                    entity = LHResponsoryEntity.class,
                    parentColumns = "responsoryID",
                    childColumns = "responsoryFK",
                    onDelete = ForeignKey.CASCADE,
                    onUpdate = ForeignKey.CASCADE)
        }
)
public class LHOfficeBiblicalEntity {
    @NonNull
    @ColumnInfo(name = "groupFK")
    public Integer groupFK=0;

    @NonNull
    @ColumnInfo(name = "readingFK")
    public Integer readingFK =0;

    @NonNull
    @ColumnInfo(name = "responsoryFK")
    public Integer responsoryFK =0;

    @NonNull
    @ColumnInfo(name = "theme")
    public String theme ="";

    @NonNull
    @ColumnInfo(name = "order", defaultValue= "1")
    public Integer order =0;
}

DAO更新方法 #

@Update(entity = LHOfficeBiblicalEntity.class,
        onConflict = OnConflictStrategy.REPLACE)
Integer lhOfficeBiblicalUpdateAll(List<LHOfficeBiblicalTable> u);

数据传输类 #

public class LHOfficeBiblicalTable {
    public Integer groupFK;
    public Integer readingFK;
    public Integer responsoryFK;
    public String theme;
    public Integer order;
}

传入的JSON数据 #

[
  {
    "groupFK":708280201,
    "readingFK":2578,
    "theme":"Pongamos sólo en Dios nuestra confianza",
    "order":1,
    "responsoryFK":690,
    "crud":"u"
  }
]

问题根源 #

Room的@Update方法（即使指定了entity参数）在使用非实体类作为更新参数时，依赖复合主键的所有字段进行行匹配。当前LHOfficeBiblicalTable的主键字段为可空的Integer类型，若JSON解析过程中某主键字段意外被解析为null，或字段值与数据库中对应行的主键不完全匹配，Room将无法定位到目标行，导致更新无效果。

此外，非实体类与实体类的字段约束不一致（实体类主键为@NonNull，传输类无约束），也可能引发匹配逻辑异常。

解决方案 #

方案1：统一字段约束，确保主键非空 #

修改LHOfficeBiblicalTable，为复合主键字段添加@NonNull注解，避免空值导致匹配失败：

public class LHOfficeBiblicalTable {
    @NonNull
    public Integer groupFK;
    @NonNull
    public Integer readingFK;
    @NonNull
    public Integer responsoryFK;
    public String theme;
    public Integer order;
}

同时验证JSON解析逻辑，确保三个主键字段均被正确解析为非空有效值。

方案2：直接使用实体类作为更新参数 #

将DAO方法的参数改为实体类LHOfficeBiblicalEntity的列表，避免非实体类的字段匹配问题：

@Update(onConflict = OnConflictStrategy.REPLACE)
Integer lhOfficeBiblicalUpdateAll(List<LHOfficeBiblicalEntity> u);

解析JSON时直接映射为LHOfficeBiblicalEntity对象，保证与Room的实体定义完全一致。

方案3：自定义更新查询（最可靠） #

通过@Query手动编写更新语句，明确指定复合主键的匹配条件，彻底避免Room自动匹配的不确定性：

@Query("UPDATE " + LH_OFFICE_BIBLICAL + " SET theme = :theme, `order` = :order " +
       "WHERE groupFK = :groupFK AND readingFK = :readingFK AND responsoryFK = :responsoryFK")
Integer lhOfficeBiblicalUpdate(Integer groupFK, Integer readingFK, Integer responsoryFK, String theme, Integer order);

// 批量更新可结合事务实现
@Transaction
default Integer lhOfficeBiblicalBatchUpdate(List<LHOfficeBiblicalTable> list) {
    int totalUpdated = 0;
    for (LHOfficeBiblicalTable item : list) {
        totalUpdated += lhOfficeBiblicalUpdate(item.groupFK, item.readingFK, item.responsoryFK, item.theme, item.order);
    }
    return totalUpdated;
}

内容的提问来源于stack exchange，提问作者A. Cedano