Firebase 字段名自动添加下划线前缀的解决方案_技术教程

firebase sdk 基于 javabean 规范解析 getter/setter 方法名，将 `get_location_name()` 误判为 `_location_name` 属性的访问器，导致写入 firestore 或 realtime database 时字段名自动带 `_` 前缀；正确做法是遵循驼峰命名（如 `getlocationname()`）或显式使用 `@propertyname` 注解指定字段名。

Firebase 在序列化 Java 对象（如 PoIs 类）到数据库时，并不直接读取私有字段名，而是依赖 JavaBean 标准命名约定：它通过反射扫描 public getter 方法（如 getXxx()），并根据方法名推断对应的数据字段名。关键规则如下：

方法 getXxx() → 推断字段名为 xxx（首字母小写，去除 get 前缀）
方法 get_xxx() → 下划线被视为单词分隔符，推断字段名为 _xxx（即保留开头下划线）
同理，is_xxx()、set_xxx(...) 等也会被识别为 _xxx 属性

在你的代码中：

public Integer get_location_id() { ... }
public String get_location_name() { ... }

Firebase 将其解析为属性 _location_id 和 _location_name，因此最终写入数据库的键名就变成了 _location_id、 _location_name、_location_address —— 这正是你观察到的现象。

✅ 推荐解决方案（二选一）

方案 1：改用标准驼峰命名（最简洁、无侵入）
重命名所有 getter/setter 方法，严格遵循 JavaBean 规范（无下划线，首字母大写）：

public class PoIs {
    private Integer locationId;        // 推荐：字段也用驼峰（非强制但最佳实践）
    private String locationName;
    private String locationAddress;

    // 构造函数保持不变（注意：原代码中构造函数有笔误：this.category_id = category_id; —— 应删除或修正）

    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;
    }
}

✅ 写入后字段名将自动变为 locationId、locationName、locationAddress（纯驼峰）。若你希望保持 location_id 这类蛇形命名，请使用方案 2。

方案 2：使用 @PropertyName 显式声明（精准控制，兼容蛇形）
在 getter/setter 或字段上添加注解（需引入 com.google.firebase.firestore.PropertyName）：

import com.google.firebase.firestore.PropertyName;

public class PoIs {
    @PropertyName("location_id")
    private Integer location_id;

    @PropertyName("location_name")
    private String location_name;

    @PropertyName("location_address")
    private String location_address;

    // 构造函数（修正原代码中的 category_id 错误）
    public PoIs(Integer location_id, String location_name, String location_address) {
        this.location_id = location_id;
        this.location_name = location_name;
        this.location_address = location_address;
    }

    // getter/setter 可保留原名，但建议同步加注解以确保双向映射一致
    @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; }

    // 其他字段同理...
}

⚠️ 注意事项：