Laravel时区转换问题：自定义Cast引发数据库查询量激增

问题根源 #

你的自定义DatetimeWithTimezone Cast导致查询量暴增的核心原因有两个：

1. set方法被意外触发：Laravel的Cast set方法本应仅在设置模型属性准备存储时调用，但实际在视图渲染（仅读取数据）场景下也被触发，导致不必要的时区查询。
2. 时区查询无缓存：company('timezone')和get_guest_timezone()每次调用都执行数据库查询，没有做缓存处理，当set方法被频繁调用时，查询量直接成倍增长。

另外，set方法返回Carbon对象而非字符串，可能会触发Laravel模型的属性变更检测，导致set方法被重复调用。

解决方案 #

1. 修复set方法的返回值（避免意外触发） #

将set方法的返回值从Carbon对象改为UTC格式的字符串，这样Laravel不会将其视为“属性变更”，也就不会在读取场景下触发set方法：

public function set($model, string $key, $value, array $attributes)
{
    if(is_null($value)) {
        return $value;
    }

    $timezone = auth()->user() ? company('timezone') : get_guest_timezone();

    // 转换为UTC后返回字符串格式，避免Carbon对象引发的意外逻辑
    return Carbon::createFromFormat('Y-m-d H:i:s', $value, $timezone)
        ->setTimezone('UTC')
        ->format('Y-m-d H:i:s');
}

2. 缓存时区查询结果（减少重复查询） #

不管是get还是set方法，每次调用时区查询函数都会触发数据库请求，必须添加缓存。可以在Cast类中复用时区获取逻辑并缓存：

class DatetimeWithTimezone implements CastsAttributes
{
    // 提取时区获取逻辑并缓存
    private function getUserTimezone(): string
    {
        $cacheKey = auth()->id() ? "user_timezone_{auth()->id()}" : 'guest_timezone';
        
        // 缓存1小时，可根据需求调整时长
        return cache()->remember($cacheKey, 3600, function () {
            return auth()->user() ? company('timezone') : get_guest_timezone();
        });
    }

    public function get($model, string $key, $value, array $attributes)
    {
        if(!is_null($value)) {
            $timezone = $this->getUserTimezone();
            $value = Carbon::createFromFormat('Y-m-d H:i:s', $value, 'UTC');
            $value->setTimezone($timezone);
        }

        return $value;
    }

    public function set($model, string $key, $value, array $attributes)
    {
        if(is_null($value)) {
            return $value;
        }

        $timezone = $this->getUserTimezone();

        return Carbon::createFromFormat('Y-m-d H:i:s', $value, $timezone)
            ->setTimezone('UTC')
            ->format('Y-m-d H:i:s');
    }
}

3. 定位set方法的意外触发源 #

如果修改后仍有问题，可以在set方法中添加日志记录调用栈，找到哪里触发了不必要的set操作：

public function set($model, string $key, $value, array $attributes)
{
    // 记录调用栈，排查触发源
    \Log::info("Set方法被触发：字段{$key}，模型" . get_class($model), [
        'call_stack' => debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 10)
    ]);

    // 原逻辑...
}

查看日志后，针对性修复那些无意中修改模型datetime属性的代码（比如视图中的赋值、模型观察者的逻辑等）。

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