按日期查询返回前一天数据问题求助

核心原因 #

Java的Date本质是时间戳对象，@DateTimeFormat(pattern = "yyyy-MM-dd")会把请求日期解析为本地时区当天0点的时间戳，但MongoDB默认以UTC时间存储和查询Date类型数据。比如东八区的当天0点对应UTC前一天16点，查询时会匹配UTC时间早于该时间的记录，也就是前一天的数据。

解决方案 #

方案1：改用LocalDate（推荐，彻底规避时区问题）

LocalDate是Java 8+的纯日期类，仅表示日期，不带时区和时间属性，完全适配纯日期查询场景。

1. 控制器修改参数类型：

@GetMapping("date")
ResponseEntity findByDate(@RequestParam @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate date) {
    log.info("date is: " + date);
    return ResponseEntity.ok(consumptionService.findByDate(date));
}

2. 仓库层同步修改参数：

public interface HourlyConsumptionRepo extends MongoRepository<HourlyConsumption, ObjectId> {
    List<HourlyConsumption> findByDate(LocalDate date);
}

3. 实体类字段修改为LocalDate（Spring Data MongoDB 2.x及以上版本支持直接存储LocalDate）：

@Document
public class HourlyConsumption {
    // 其他字段
    private LocalDate date;
    // Getter、Setter方法
}

方案2：使用日期范围查询（兼容旧代码）

如果必须保留Date类型，可通过查询当天完整时间范围（本地时区当天0点到次日0点），避免精确时间戳匹配的时区偏差。

1. 控制器计算时间范围：

@GetMapping("date")
ResponseEntity findByDate(@RequestParam @DateTimeFormat(pattern = "yyyy-MM-dd") Date date) {
    log.info("original date is: " + date);
    // 构建当天起始时间（本地时区0点0分0秒）
    Calendar cal = Calendar.getInstance();
    cal.setTime(date);
    cal.set(Calendar.HOUR_OF_DAY, 0);
    cal.set(Calendar.MINUTE, 0);
    cal.set(Calendar.SECOND, 0);
    cal.set(Calendar.MILLISECOND, 0);
    Date startTime = cal.getTime();
    
    // 构建次日起始时间
    cal.add(Calendar.DATE, 1);
    Date endTime = cal.getTime();
    
    log.info("query start: " + startTime + ", end: " + endTime);
    return ResponseEntity.ok(consumptionService.findByDateBetween(startTime, endTime));
}

2. 仓库新增范围查询方法：

public interface HourlyConsumptionRepo extends MongoRepository<HourlyConsumption, ObjectId> {
    List<HourlyConsumption> findByDateBetween(Date start, Date end);
}

方案3：统一MongoDB时区配置

通过配置让Spring Data MongoDB使用指定时区处理Date类型，消除时区转换差异。

在application.properties中添加配置：

# 替换为你的本地时区，例如东八区用Asia/Shanghai
spring.data.mongodb.timezone=Asia/Shanghai

或自定义Mongo转换器（适用于复杂场景）：

@Configuration
public class MongoConfig {
    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        List<Converter<?, ?>> converters = new ArrayList<>();
        converters.add(DateToLocalDateTimeConverter.INSTANCE);
        converters.add(LocalDateTimeToDateConverter.INSTANCE);
        return new MongoCustomConversions(converters);
    }

    enum DateToLocalDateTimeConverter implements Converter<Date, LocalDateTime> {
        INSTANCE;

        @Override
        public LocalDateTime convert(Date source) {
            return source == null ? null : LocalDateTime.ofInstant(source.toInstant(), ZoneId.systemDefault());
        }
    }

    enum LocalDateTimeToDateConverter implements Converter<LocalDateTime, Date> {
        INSTANCE;

        @Override
        public Date convert(LocalDateTime source) {
            return source == null ? null : Date.from(source.atZone(ZoneId.systemDefault()).toInstant());
        }
    }
}

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