0

0

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

聖光之護

聖光之護

发布时间:2026-01-21 16:55:03

|

866人浏览过

|

来源于php中文网

原创

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 —— 这正是你观察到的现象。

推荐解决方案(二选一)

燕雀Logo
燕雀Logo

为用户提供LOGO免费设计在线生成服务

下载

方案 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
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

841

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

742

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

738

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

399

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16926

2023.08.03

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.7万人学习

C# 教程
C# 教程

共94课时 | 7.2万人学习

Java 教程
Java 教程

共578课时 | 48.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号