Firestore的document.toObject无法复制以is开头的字段至Kotlin POJO

我之前在项目里也踩过这个Kotlin和Firestore序列化的坑！这个问题的根源其实是Kotlin布尔属性的命名规则和JavaBean规范的交互差异，导致Firestore找不到对应的字段映射方法。

问题原因拆解： #

当你在Kotlin里定义var isAccepted: Boolean时，编译器会自动生成符合Kotlin习惯的getter和setter：

• Getter方法是isAccepted()（和Java一致）
• 但Setter方法会被生成为setAccepted(Boolean)，而不是Java里的setIsAccepted(Boolean)

Firestore的toObject()方法是基于JavaBean规范来匹配字段的：它会根据文档里的键名isAccepted，去寻找名为setIsAccepted的Setter方法。但Kotlin生成的是setAccepted，自然匹配不上，所以这个字段就没法被赋值。而Java中直接定义boolean isAccepted时，生成的Setter就是setIsAccepted，所以能正常工作。

推荐解决方案 #

下面给你几个实用的解决办法，按推荐程度排序：

方案1：用@PropertyName注解显式绑定字段名

这是最简洁直观的方案，直接告诉Firestore文档里的isAccepted键对应POJO里的哪个属性：

import com.google.firebase.firestore.PropertyName

data class MyPojo(
    // 其他正常字段
    @PropertyName("isAccepted")
    var isAccepted: Boolean = false
)

添加这个注解后，Firestore会忽略默认的JavaBean规则，直接按注解指定的键名来映射，完美解决问题。

方案2：调整属性命名适配JavaBean规范

如果不想用注解，可以把属性名改成accepted，同时手动保留isAccepted的getter，兼顾Kotlin的使用习惯和Firestore的映射规则：

data class MyPojo(
    // 其他正常字段
    private var accepted: Boolean = false
) {
    // 对外暴露和原字段名一致的getter
    fun isAccepted(): Boolean = accepted
    // 让Firestore能识别的setter
    fun setAccepted(accepted: Boolean) {
        this.accepted = accepted
    }
}

不过这种方式需要手动编写getter和setter，不如注解方便，适合不想引入Firestore注解的场景。

方案3：用@JvmName修改Setter方法名

通过Kotlin的@JvmName注解，强制让编译器生成Firestore期望的setIsAccepted方法：

data class MyPojo(
    // 其他正常字段
    var isAccepted: Boolean = false
) {
    @JvmName("setIsAccepted")
    fun setIsAccepted(value: Boolean) {
        isAccepted = value
    }
}

这样Firestore就能找到对应的Setter方法，完成字段赋值，但需要额外编写一个Setter方法，略显繁琐。

总结 #

最推荐用方案1，@PropertyName注解既简洁又能明确字段映射关系，避免后续因为命名规则产生其他问题。

内容的提问来源于stack exchange，提问作者Nikhil BHadouria