Android向Firebase存储自定义对象列表时出现setItemId setter冲突如何解决？

问题根因 #

该报错是Firebase Realtime Database序列化自定义对象时，通过反射扫描类的setter方法检测到重名冲突导致的，常见触发场景和解决方案如下：

解决方案 #

1. 校验itemId对应的getter/setter方法签名 #

你的itemId字段声明为long类型，必须保证getter、setter签名严格匹配，且无重载的同名方法：

// 正确签名，不能有其他同名setItemId方法（比如参数为int、String的重载方法）
public long getItemId() {
    return itemId;
}

public void setItemId(long itemId) {
    this.itemId = itemId;
}

如果存在多个重载的setItemId方法，直接删除多余的重载即可。

2. 排查序列化注解冲突 #

检查OrderModel类、itemId字段、对应getter/setter上是否加了重复的@PropertyName注解，比如同时给字段、getter、setter都绑定了同一个属性名，会被Firebase识别为重复映射。如果有重复注解，仅保留字段上的1个即可，或者给不需要序列化的方法加@Exclude注解。
如果你的类存在父类，且父类中也存在setItemId方法，需要给父类的同名setter加@Exclude注解，避免被Firebase扫描到。

3. 补充混淆规则 #

如果开启了代码混淆（build.gradle中minifyEnabled为true），需要在proguard-rules.pro中添加实体类防混淆规则，避免编译期篡改方法签名导致冲突：

# 保留OrderModel类所有成员不被混淆
-keep class com.sabirali.myorder.Models.OrderModel { *; }
# Firebase通用混淆规则
-keepattributes Signature
-keepclassmembers class com.google.firebase.** { *; }

4. 添加类序列化注解 #

直接在OrderModel类上添加以下注解，强制Firebase按照规则序列化，规避多余方法扫描：

import androidx.annotation.Keep;
import com.google.firebase.database.IgnoreExtraProperties;

@Keep // 避免类被混淆
@IgnoreExtraProperties // 忽略类中未映射到数据库字段的多余方法
public class OrderModel {
    // 原有类代码不变
}

内容的提问来源于stack exchange，提问作者Sabir Ali