使用Spring Repository查询MongoDB时空日期转换失败问题

针对你遇到的ConversionFailedException（空值/空字符串无法转换为LocalDate/LocalDateTime），可以用以下几种方案解决：

方案1：自定义类型转换器 #

编写自定义转换器，直接将空字符串、null转为null，避免触发无效的日期转换：

import org.springframework.core.convert.converter.Converter;
import org.springframework.data.convert.ReadingConverter;
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

@ReadingConverter
public class StringToLocalDateConverter implements Converter<String, LocalDate> {

    private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ISO_LOCAL_DATE;

    @Override
    public LocalDate convert(String source) {
        if (source == null || source.trim().isEmpty()) {
            return null;
        }
        return LocalDate.parse(source, FORMATTER);
    }
}

将转换器注册到Mongo配置类中：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MongoCustomConversions;
import java.util.List;

@Configuration
public class MongoConfig {

    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        return new MongoCustomConversions(List.of(new StringToLocalDateConverter()));
    }
}

如果是LocalDateTime类型，同理编写对应的StringToLocalDateTimeConverter即可。

方案2：用Optional包装日期字段 #

在MyObject实体类中，将日期字段用Optional包装，当字段不存在或为空时，会自动映射为Optional.empty()，不会触发转换错误：

import java.time.LocalDate;
import java.util.Optional;

public class MyObject {
    private String idObject;
    private Optional<LocalDate> createDate; // 用Optional包装日期字段
    // 其他字段、getter/setter方法
}

查询后可通过obj.getCreateDate().orElse(null)获取实际值。

方案3：修正MongoDB中的数据格式 #

如果MongoDB中日期字段存的是空字符串，建议批量更新为null或直接删除该字段（空字符串本身不符合日期格式，转换必然失败）：

// MongoDB Shell命令：将空字符串的createDate字段更新为null
db.myObject.updateMany(
  { createDate: "" },
  { $set: { createDate: null } }
)

更新后，Spring Data MongoDB会自动将null映射到实体类的日期字段（需确保实体类字段未添加@NotNull等非空约束）。

方案4：全局配置忽略空值转换 #

通过配置MappingMongoConverter，让全局转换时跳过空值处理：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MappingMongoConverter;
import org.springframework.data.mongodb.core.mapping.MongoMappingContext;

@Configuration
public class MongoConfig {

    @Bean
    public MappingMongoConverter mappingMongoConverter(MongoMappingContext context) {
        MappingMongoConverter converter = new MappingMongoConverter(null, context);
        converter.setSkipNullProperties(true); // 跳过空值属性的转换
        return converter;
    }
}

注意：该配置会对所有实体类的空值字段生效。

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