Laravel按用户时区返回数据显示异常问题排查

问题根源 #

你当前查询逻辑的核心错误在于时间时区转换顺序颠倒：

• Carbon::now()->startOfDay()->tz($user->timezone) 是先以UTC时区获取当天零点，再转换到用户时区。这个时间并非用户时区的当天零点，而是UTC当天零点对应的用户时区时间，会导致查询范围偏移。
• 比如用户时区为西五区（UTC-5），当UTC时间为上午10点时，UTC的当天零点转换为西五区是前一天的19点——用这个时间作为查询起始，会把前一天19点之后（对应UTC当天零点之前）的记录也纳入结果，也就是你遇到的"本地午夜过后仍显示前一天记录"的问题。

修复方案 #

正确逻辑是：先切换到用户时区获取当天的起止时间，再转换回UTC（匹配数据库存储的时区），以此作为查询范围。

修改后的代码如下：

// 获取用户时区的当天起止时间，并转换为UTC
$userTimezone = $user->timezone;
$todayStart = Carbon::now($userTimezone)->startOfDay()->setTimezone('UTC');
$todayEnd = Carbon::now($userTimezone)->endOfDay()->setTimezone('UTC');

// 查询该用户当天（用户时区）的手术记录
$todayProcedures = Procedure::query()
    ->where('user_id', $user->id)
    ->whereBetween('procedure_time', [$todayStart, $todayEnd])
    ->get();

补充说明 #

• 你存入数据的逻辑是正确的：将用户时区的时间解析后转换为UTC存入数据库，符合统一时区存储的最佳实践。
• 使用whereBetween替代两个whereDate，逻辑更简洁，同时避免whereDate可能带来的时区转换歧义（whereDate会将数据库字段转换为应用时区（UTC）后再提取日期，直接用UTC时间范围匹配更精准）。

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