MongoDB插入时丢失isSpeciesOrVariety字段问题排查

你的问题并非MongoDB的bug，而是序列化配置不匹配导致的——内存中的对象字段值正确，但插入数据库时该字段未被序列化写入。以下是具体排查和解决步骤：

1. 确认MongoDB Kotlin驱动类型与注解匹配 #

你当前使用@SerialName注解（属于kotlinx.serialization），但需要确保项目依赖的是MongoDB Kotlin Serialization Driver，而非基于Java驱动的kotlin协程版本。两种驱动的序列化逻辑完全不同：

• 若使用mongodb-kotlin-serialization-driver：@SerialName才会生效，且需正确配置序列化注册表。
• 若使用普通的mongodb-driver-kotlin-coroutine：需替换为MongoDB官方的@BsonProperty注解来映射字段名。

对应调整方案 #

情况1：使用Serialization Driver

确保初始化MongoClient时注册Kotlin序列化器：

import org.litote.kmongo.coroutine.coroutine
import org.litote.kmongo.reactivestreams.KMongo
import kotlinx.serialization.json.Json

val mongoClient = KMongo.createClient("mongodb://localhost:27017").coroutine
val database = mongoClient.getDatabase("garden_db").withCodecRegistry(
    KotlinCodecRegistry.fromRegistries(
        MongoClientSettings.getDefaultCodecRegistry(),
        SerializersModule {
            contextual(PlantSpeciesDetails.serializer())
        }
    )
)
val plants = database.getCollection<PlantSpeciesDetails>("plants")

情况2：使用普通Coroutine Driver

将@SerialName替换为@BsonProperty：

import org.bson.codecs.pojo.annotations.BsonProperty

@Serializable
data class PlantSpeciesDetails(
    // ... 其他字段
    @BsonProperty("isSpeciesOrVariety")
    val isSpeciesOrVariety: String,
    // ... 其他字段
)

2. 验证序列化结果 #

在插入前手动序列化对象，确认输出的JSON包含目标字段：

val json = Json.encodeToString(plant)
println(json) // 检查输出是否包含"isSpeciesOrVariety"键

如果此处输出的JSON缺失该字段，说明kotlinx.serialization的注解处理器未正常工作——尝试清理项目缓存（如Gradle的clean任务）后重新构建。

3. 排除冲突依赖 #

检查项目依赖，避免同时引入Jackson和kotlinx.serialization的MongoDB驱动扩展，这会导致序列化逻辑冲突。例如：

// 错误：同时引入两种序列化驱动
implementation("org.mongodb:mongodb-kotlin-serialization-driver:4.10.1")
implementation("org.mongodb.kotlin:mongodb-driver-kotlin-coroutine:4.10.1")

需只保留其中一种驱动依赖。

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