Kotlin泛型数据类生成桥接Getter/Setter导致Firestore无法忽略@Exclude注解字段的问题

我之前也碰到过一模一样的问题，本质原因是JVM泛型类型擦除机制导致Kotlin自动生成了桥接方法——你只给原始泛型类型的getter/setter加了@Exclude注解，但那些桥接的Object类型方法并没有带上注解，Firestore扫描到无注解的桥接getter后，就会把details字段保存进去。

下面给你几个可行的解决方案，按实现复杂度从低到高排序：

方案一：给接口的属性统一添加@Exclude注解 #

既然桥接方法是因为实现泛型接口产生的，那我们直接在接口的属性上添加@Exclude，这样所有实现类的桥接方法都会继承这个注解。修改你的DetailableModel接口：

interface DetailableModel<TDetailsModel> {
    @get:com.google.firebase.firestore.Exclude
    @set:com.google.firebase.firestore.Exclude
    var details: TDetailsModel?
}

然后在RoomV2里只需要正常override这个属性，不需要重复加注解：

data class RoomV2(
    // 你的其他字段
) : DetailableModel<RoomDetails> {
    /** Firestore构造函数 */
    constructor() : this(/* 你的默认参数 */)

    override var details: RoomDetails? = null
    // 其他代码
}

这样生成的桥接方法也会带上@Exclude注解，Firestore就能正确忽略这个字段了。

方案二：使用字段级别的@Exclude注解 #

换一种注解方式，直接把@Exclude标记在字段本身，而不是getter/setter上。这样不管Kotlin生成多少桥接方法，Firestore都会直接忽略这个字段：

data class RoomV2(
    // 你的其他字段
) : DetailableModel<RoomDetails> {
    constructor() : this(/* 你的默认参数 */)

    @field:com.google.firebase.firestore.Exclude
    override var details: RoomDetails? = null
    // 其他代码
}

这种方式更直接，不需要修改接口定义，适合不想改动接口结构的场景。

方案三：自定义Firestore转换器（Converter） #

如果上面两种方法都不适用，你可以完全接管序列化/反序列化过程，自己控制哪些字段需要保存。创建一个转换器类：

class RoomV2Converter : FirebaseFirestoreConverter<RoomV2> {
    override fun toFirestore(model: RoomV2): Map<String, Any> {
        // 手动构建要保存的字段，排除details
        return mapOf(
            // 替换成你的实际字段，比如：
            "roomId" to model.roomId,
            "roomName" to model.roomName,
            // 其他需要保存的字段...
        )
    }

    override fun fromFirestore(data: Map<String, Any>, snapshot: DocumentSnapshot): RoomV2 {
        // 从Firestore的数据中重建RoomV2实例，details可以设为null或按需处理
        return RoomV2(
            roomId = data["roomId"] as String,
            roomName = data["roomName"] as String,
            // 其他字段...
        ).apply {
            details = null // 或者根据业务逻辑初始化
        }
    }
}

使用的时候注册这个转换器：

val db = FirebaseFirestore.getInstance()
val roomsRef = db.collection("rooms").withConverter(RoomV2Converter())

// 保存数据示例
val room = RoomV2(/* 初始化参数 */)
roomsRef.add(room)

这种方式灵活性最高，适合需要复杂序列化逻辑的场景。

备注：内容来源于stack exchange，提问作者Dorian Pavetić