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;
}
}⚠️ 注意事项：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- @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 是应对遗留命名约束的可靠兜底手段。二者择一，即可彻底解决字段名意外带 _ 前缀的问题。
