如何通过MongoTemplate让Azure Cosmos DB以MongoDB格式存储LocalDateTime

针对Spring Boot使用MongoTemplate向Azure Cosmos DB（Mongo API）存储LocalDateTime时格式与本地MongoDB不一致的问题，可通过以下几种方案解决：

方案一：给字段添加Jackson格式化注解 #

直接在实体类的LocalDateTime字段上添加@JsonFormat注解，指定序列化为ISO-8601格式的字符串，这样本地MongoDB和Cosmos DB都会存储相同格式的字符串：

public class YourEntity {
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSXXX")
    private LocalDateTime timestamp;
    
    // 其他字段、getter/setter方法
}

方案二：配置全局Mongo自定义转换器 #

通过自定义类型转换器，全局处理所有LocalDateTime字段的存储与读取逻辑，统一转换为ISO格式字符串：

@Configuration
public class MongoConfig {
    @Bean
    public MongoTemplate mongoTemplate(MongoDatabaseFactory mongoDbFactory) {
        MappingMongoConverter converter = new MappingMongoConverter(
                new DefaultDbRefResolver(mongoDbFactory), 
                new MongoMappingContext()
        );
        converter.setCustomConversions(customConversions());
        return new MongoTemplate(mongoDbFactory, converter);
    }

    private CustomConversions customConversions() {
        List<Converter<?, ?>> converters = new ArrayList<>();
        // 存储时：LocalDateTime转ISO字符串
        converters.add((Converter<LocalDateTime, String>) source -> 
                source.format(DateTimeFormatter.ISO_OFFSET_DATE_TIME));
        // 读取时：ISO字符串转LocalDateTime
        converters.add((Converter<String, LocalDateTime>) source -> 
                LocalDateTime.parse(source, DateTimeFormatter.ISO_OFFSET_DATE_TIME));
        return new CustomConversions(converters);
    }
}

方案三：调整MongoClient的序列化配置 #

通过配置MongoClient的CodecRegistry，指定使用Jackson序列化规则，让Cosmos DB的序列化逻辑与本地MongoDB对齐：

@Bean
public MongoClient mongoClient() {
    ConnectionString connectionString = new ConnectionString("你的Cosmos DB连接字符串");
    MongoClientSettings settings = MongoClientSettings.builder()
            .applyConnectionString(connectionString)
            .codecRegistry(CodecRegistries.fromRegistries(
                    MongoClientSettings.getDefaultCodecRegistry(),
                    CodecRegistries.fromProviders(new JacksonCodecProvider())
            ))
            .build();
    return MongoClients.create(settings);
}

注意事项 #

• 如果选择将日期存储为字符串，查询时需注意用字符串规则进行比较，或在查询时转换格式；若仅需显示格式一致，其实两种存储都是BSON日期类型，只是客户端展示方式不同，无需修改存储逻辑，只需在查询后统一格式化输出即可。
• 确保Spring Data MongoDB版本与Azure Cosmos DB的Mongo API版本兼容，避免序列化冲突。

内容的提问来源于stack exchange，提问作者S-Wing