使用Java关键字作为Realm实体属性名时数据保存异常如何解决
异常原因
- 核心触发原因是字段命名冲突:
long是 Java、Kotlin 共同的保留关键字,直接将其作为实体类属性名使用时,Realm 生成字段映射代理类的过程中会出现识别错误,实际写入数据时没有将负数经度值绑定到对应字段,读取时只能拿到属性声明的默认值 0.0。 - 少数 10.6.0 版本之前的 Realm 存在可空浮点型字段负数值序列化漏洞,也会触发相同的异常表现。
解决方案
- 优先修改字段名避开保留关键字,比如将
long改为语义更明确的longitude,修改后的实体类示例如下:
open class Location( var lat: Double? = 0.0, var longitude: Double? = 0.0 ) : RealmObject()
如果业务逻辑中必须保留long作为对外暴露的字段名,可以通过@RealmField注解指定映射的数据库字段名,同时用反引号转义属性名避免语法冲突:
open class Location( var lat: Double? = 0.0, @RealmField(name = "long") var `long`: Double? = 0.0 ) : RealmObject()
- 若排查确认是版本漏洞导致的问题,将 Realm 依赖升级到 10.6.0 及以上的稳定版即可修复。
- 验证逻辑:修改完成后可写入测试负数值(如-120.0),查询后直接打印对应字段值确认写入读取逻辑正常。
内容的提问来源于stack exchange,提问作者Eugen Martynov
相关产品推荐
相关产品推荐

