Firebase 字段名自动添加下划线的解决方案

firebase sdk 基于 javabean 规范解析 getter/setter 方法名，将 `get_location_id()` 误判为 `_location_id` 属性的访问器，导致字段在数据库中自动带前导下划线；修复方法包括修正命名风格或使用 `@propertyname` 注解显式指定字段名。

Firebase Realtime Database（及 Firestore）在序列化 Java 对象时，严格遵循 JavaBeans 规范：它通过反射扫描 public getter 方法（如 getXxx()），并依据驼峰命名规则推断对应属性名。关键规则是：

• 方法名必须以 get 开头

  

  ，后接首字母大写的属性名（如 getLocationName() → locationName）；
• 若方法名为 get_location_name()，SDK 会将其拆解为 _ + location_name，即把下划线视为分隔符，并将后续部分首字母大写 → _location_name → 属性名判定为 _location_name；
• 因此 get_location_id() 被映射为 _location_id，最终写入数据库的字段名就是 "_location_id"。

✅ 正确做法一：遵守标准 JavaBean 命名（推荐）
重命名所有 getter/setter 方法，使用驼峰式（camelCase），并保持字段名与之语义一致：

public class PoIs {
    private Integer locationId;          // 字段名改为 camelCase
    private String locationName;
    private String locationAddress;

    public PoIs() {}

    public PoIs(Integer locationId, String locationName, String locationAddress) {
        this.locationId = locationId;
        this.locationName = locationName;
        this.locationAddress = locationAddress;
    }

    // ✅ 正确的 getter：驼峰式，无下划线
    public Integer getLocationId() {
        return locationId;
    }

    public void setLocationId(Integer locationId) {
        this.locationId = locationId;
    }

    public String getLocationName() {
        return locationName;
    }

    public void setLocationName(String locationName) {
        this.locationName = locationName;
    }

    public String getLocationAddress() {
        return locationAddress;
    }

    public void setLocationAddress(String locationAddress) {
        this.locationAddress = locationAddress;
    }
}

✅ 正确做法二：使用 @PropertyName 显式声明（兼容旧命名）
若因历史原因需保留下划线字段名（如与 SQLite 表结构强绑定），可在 getter/setter 或字段上添加 @PropertyName 注解（需引入 Firebase Android BoM 或对应依赖）：

import com.google.firebase.database.Exclude;
import com.google.firebase.database.PropertyName;

public class PoIs {
    private Integer location_id;
    private String location_name;
    private String location_address;

    // ✅ 显式指定数据库字段名为 "location_id"（无前导下划线）
    @PropertyName("location_id")
    public Integer get_location_id() {
        return location_id;
    }

    @PropertyName("location_id")
    public void set_location_id(Integer location_id) {
        this.location_id = location_id;
    }

    @PropertyName("location_name")
    public String get_location_name() {
        return location_name;
    }

    @PropertyName("location_name")
    public void set_location_name(String location_name) {
        this.location_name = location_name;
    }

    @PropertyName("location_address")
    public String get_location_address() {
        return location_address;
    }

    @PropertyName("location_address")
    public void set_location_address(String location_address) {
        this.location_address = location_address;
    }
}

⚠️ 注意事项：

• @PropertyName 必须同时标注 getter 和 setter（若两者均存在），否则序列化/反序列化可能不一致；
• 若字段为 public（不推荐），也可直接标注在字段上：@PropertyName("location_id") public Integer location_id;；
• 确保已添加 Firebase Database 依赖（如 com.google.firebase:firebase-database），且版本 ≥ 16.0.1（@PropertyName 自此版本起支持）；
• 切勿混用两种风格：例如字段用 location_id + getter 用 getLocationId()，会导致映射冲突或静默失败。

? 验证建议：
在调用 setValue(p) 前，可先打印序列化结果辅助调试：

Log.d("FirebaseDebug", "Serialized: " + new com.google.firebase.database.core.utilities.JsonMapper().writeValueAsString(p));

或使用 Firebase Console 实时观察实际写入的 key 名。

总结：Firebase 的字段名生成逻辑是确定性的、可预测的。坚持标准 JavaBean 命名（驼峰式）是最简洁、可维护性最强的方案；而 @PropertyName 是应对遗留命名约束的可靠兜底手段。二者择一，即可彻底解决字段名意外带 _ 前缀的问题。