如何在Spring Data中将Kotlin LocalDate或LocalDateTime序列化为BsonDateTime？

看起来你碰到了Spring Data Mongo和Kotlin序列化体系之间的适配问题——想用@Serializable和@Contextual让LocalDate直接转成Mongo的BsonDateTime，但结果却被包在了{value: BsonDateTime}结构里。我来帮你分析原因并给出两种可行的解决方案。

问题原因分析 #

你在调试中发现的点很关键：Spring Data Mongo默认会把你的Model对象转换成Document实例再写入数据库，而不是直接交给Mongo的Kotlin序列化器处理。这就导致你加的@Serializable和@Contextual注解没起到预期作用——Spring Data的默认转换机制并没有识别这些Kotlin序列化注解，而是把LocalDate当成普通数据类处理，所以才会把它的内部结构（比如value字段）存进Mongo。

解决方案一：使用Spring Data自定义转换器（最通用） #

这是Spring Data生态的标准做法，通过注册自定义转换器，让Spring直接把LocalDate转成BsonDateTime类型，跳过默认的对象拆解逻辑。

1. 编写读写转换器 #

首先创建两个转换器：一个负责把LocalDate转成BsonDateTime（写入数据库），另一个负责把BsonDateTime转回LocalDate（读取数据库）：

import org.springframework.core.convert.converter.Converter
import org.springframework.data.convert.ReadingConverter
import org.springframework.data.convert.WritingConverter
import org.bson.BsonDateTime
import java.time.LocalDate
import java.time.ZoneOffset

// 写入数据库时的转换器
@WritingConverter
class LocalDateToBsonDateTimeConverter : Converter<LocalDate, BsonDateTime> {
    override fun convert(source: LocalDate): BsonDateTime {
        // 把LocalDate转成UTC时区的Instant，再转成毫秒时间戳
        val instant = source.atStartOfDay(ZoneOffset.UTC).toInstant()
        return BsonDateTime(instant.toEpochMilli())
    }
}

// 读取数据库时的转换器
@ReadingConverter
class BsonDateTimeToLocalDateConverter : Converter<BsonDateTime, LocalDate> {
    override fun convert(source: BsonDateTime): LocalDate {
        return LocalDate.ofInstant(source.value, ZoneOffset.UTC)
    }
}

2. 注册转换器到Spring容器 #

创建一个配置类，把上面的转换器注册到Spring Data Mongo的转换体系中：

import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.data.mongodb.core.convert.MongoCustomConversions

@Configuration
class MongoConversionConfig {
    @Bean
    fun mongoCustomConversions(): MongoCustomConversions {
        val converters = listOf(
            LocalDateToBsonDateTimeConverter(),
            BsonDateTimeToLocalDateConverter()
        )
        return MongoCustomConversions(converters)
    }
}

这样配置后，Spring Data在处理Model中的LocalDate字段时，会直接调用转换器把它转成BsonDateTime，最终存到Mongo里的就是标准的$date格式，不会有多余的value包裹。

解决方案二：启用Mongo的Kotlinx序列化支持（Kotlin原生风格） #

如果你想统一使用Kotlin的序列化体系，而不是Spring Data的转换机制，可以配置Spring Data使用Mongo官方提供的Kotlinx序列化转换器。

1. 确保依赖正确 #

确认你的build.gradle.kts中包含以下依赖（版本尽量匹配你的Kotlin版本）：

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-data-mongodb")
    implementation("org.jetbrains.kotlin:kotlin-reflect")
    implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.6.2")
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-core:1.6.3")
    implementation("org.mongodb:bson-kotlinx:4.11.1") // 版本与Mongo Driver匹配
}

2. 配置Kotlinx序列化转换器 #

创建配置类，替换Spring Data默认的转换器为KotlinxSerializationMongoConverter：

import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.data.mongodb.core.MongoTemplate
import org.springframework.data.mongodb.core.convert.KotlinxSerializationMongoConverter
import org.springframework.data.mongodb.core.mapping.MongoMappingContext
import com.mongodb.kotlin.client.MongoClients

@Configuration
class MongoSerializationConfig {

    @Bean
    fun mongoConverter(mappingContext: MongoMappingContext): KotlinxSerializationMongoConverter {
        val converter = KotlinxSerializationMongoConverter(mappingContext)
        // 可以保留自定义转换器，这里先设为空，后续按需添加
        converter.setCustomConversions(org.springframework.data.mongodb.core.convert.MongoCustomConversions.empty())
        return converter
    }

    @Bean
    fun mongoTemplate(mongoConverter: KotlinxSerializationMongoConverter): MongoTemplate {
        val mongoClient = MongoClients.create("mongodb://localhost:27017") // 替换成你的Mongo地址
        return MongoTemplate(mongoClient, "your-database-name", mongoConverter)
    }
}

3. 调整数据类注解 #

确保你的Model类上的注解正确，@Contextual会让Kotlin序列化器使用Mongo提供的上下文序列化器来处理LocalDate：

import kotlinx.serialization.Serializable
import org.bson.types.ObjectId
import org.springframework.data.mongodb.core.mapping.Contextual

@Serializable
data class Model(
    @Contextual val id: ObjectId,
    @Contextual val date: LocalDate
)

这样配置后，Spring Data会直接把对象交给Mongo的Kotlinx序列化器处理，LocalDate会被正确序列化为BsonDateTime，不再出现value包裹的问题。

关于你尝试的自定义序列化器的问题 #

你之前尝试的LocalDateConverter用了Mongo的StrictJsonWriter，那是Mongo原生序列化器的API，但Spring Data用的是自己的转换体系，所以两者不兼容。上面的两种方案都是贴合Spring Data生态的正确做法，不用再纠结那个StrictJsonWriter的问题啦。

内容来源于stack exchange