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

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

发布时间 - 2026-01-21 00:00:00 点击率：次

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

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

⚠️ 注意事项：

@PropertyName 注解需同时作用于 getter 和 setter（或字段），否则反序列化（读取）可能失败；
若使用 Firestore，确保类已添加无参构造函数（你已有 public PoIs() {}，符合要求）；
Realtime Database 同样支持 @PropertyName，但仅限 Android SDK v16.0.1+；
原代码构造函数中存在未定义变量 category_id，请务必检查并移除该行，避免编译错误。

? 验证方式：
在 setValue(p) 后，打开 Firebase Console → Realtime Database 或 Firestore 控制台，查看实际写入的 key 名是否已符合预期（如 location_name 而非 _location_name）。

总结：Firebase 的“自动加下划线”本质是 JavaBean 命名推导逻辑的副作用，而非 Bug。统一采用驼峰命名（getLocationName）是最符合生态规范、零配置、长期可维护的选择；而 @PropertyName 则为你保留蛇形命名提供了灵活且可靠的兜底方案。

# java # android # go # google # 编译错误

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：Edge浏览器朗读功能怎么用 Edge大声朗读网页内容使用方

下一篇：得物达人招募官网入口得物平台达人招募手机端报名入口

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：Edge浏览器朗读功能怎么用 Edge大声朗读网页内容使用方

下一篇：得物达人招募官网入口得物平台达人招募手机端报名入口