多MongoDB连接下Date转ZonedDateTime转换器失效问题求助

以下是针对你遇到的转换器未生效问题的排查方向和解决方案：

1. 核心问题：转换器未注册到所有MongoTemplate实例 #

多MongoDB连接场景下，每个MongoTemplate对应的MappingMongoConverter都需要单独配置自定义转换器，仅全局注册一次转换器不会自动应用到所有连接实例。

正确配置示例 #

@Configuration
public class MongoCfg {

    // 第一个MongoDB连接的MongoTemplate
    @Bean(name = "mongoTemplate1")
    public MongoTemplate mongoTemplate1(MongoClient mongoClient1) {
        MappingMongoConverter converter = buildMappingConverter(mongoClient1, "db1");
        return new MongoTemplate(new SimpleMongoClientDatabaseFactory(mongoClient1, "db1"), converter);
    }

    // 第二个MongoDB连接的MongoTemplate
    @Bean(name = "mongoTemplate2")
    public MongoTemplate mongoTemplate2(MongoClient mongoClient2) {
        MappingMongoConverter converter = buildMappingConverter(mongoClient2, "db2");
        return new MongoTemplate(new SimpleMongoClientDatabaseFactory(mongoClient2, "db2"), converter);
    }

    // 复用的转换器构建逻辑
    private MappingMongoConverter buildMappingConverter(MongoClient client, String dbName) {
        DefaultDbRefResolver dbRefResolver = new DefaultDbRefResolver(new MongoDatabaseFactorySupport(client, dbName) {});
        MongoMappingContext mappingContext = new MongoMappingContext();
        
        MappingMongoConverter converter = new MappingMongoConverter(dbRefResolver, mappingContext);
        converter.setCustomConversions(customConversions()); // 注入自定义转换器
        converter.afterPropertiesSet();
        
        return converter;
    }

    // 定义全局转换器集合
    @Bean
    public CustomConversions customConversions() {
        List<Converter<?, ?>> converters = new ArrayList<>();
        converters.add(new DateToZonedDateTimeConverter());
        converters.add(new ZonedDateTimeToDateConverter());
        return new CustomConversions(converters);
    }
}

2. 检查转换器泛型与逻辑正确性 #

确保转换器的泛型参数严格匹配Date和ZonedDateTime，避免类型声明错误：

// Date转ZonedDateTime
public class DateToZonedDateTimeConverter implements Converter<Date, ZonedDateTime> {
    @Override
    public ZonedDateTime convert(Date source) {
        return source == null ? null : source.toInstant().atZone(ZoneId.systemDefault());
    }
}

// ZonedDateTime转Date
public class ZonedDateTimeToDateConverter implements Converter<ZonedDateTime, Date> {
    @Override
    public Date convert(ZonedDateTime source) {
        return source == null ? null : Date.from(source.toInstant());
    }
}

• 注意不要将泛型写成LocalDateTime或其他时间类型
• 空值判断避免NPE，同时符合Spring Data转换器的预期行为

3. 实体类字段配置验证 #

确保实体类中ZonedDateTime字段的注解无冲突：

public class BizEntity {
    private String id;
    @Field("create_time") // 仅需指定数据库字段名，无需额外转换注解
    private ZonedDateTime createTime;
    
    // getter/setter
}

不需要添加@Convert等额外注解，Spring Data MongoDB会自动匹配已注册的转换器。

4. 版本兼容性排查 #

部分旧版本Spring Data MongoDB（如3.0.x及以下）对Java 8时间类型的支持存在bug，建议升级到3.3.x及以上的稳定版本，避免版本兼容问题。

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