laravel里面操作clickhouse遇到时区大坑问题

🧩 背景问题

• ClickHouse 的 DateTime / DateTime64 字段默认使用 UTC 存储和解释；
• Laravel（PHP）默认使用 Asia/Shanghai（北京时间）；
• 用户传入或前端展示通常基于本地时间；

• 如果不统一时区，会导致：

  • 查询不到预期数据；
  • 数据入库时间看起来“不对”；
  • 日志、展示时间混乱。

🚨 常见误区

✅ 推荐做法（生产级）

1️⃣ Laravel 端统一所有时间查询为 UTC

封装一个工具函数（用于生成 ClickHouse 的时间字符串）：

function formatUtcDateTime64($datetime)
{
    return substr(
        Carbon\Carbon::parse($datetime)
            ->setTimezone('UTC')
            ->format('Y-m-d H:i:s.u'),
        0,
        23 // 保留到毫秒
    );
}

示例查询构造：

$start = formatUtcDateTime64($params['start_time']);
$where[] = "last_threat_time >= toDateTime64('{$start}', 3)";

2️⃣ Laravel 中 config 设置默认本地时区（非必要但建议）

// config/app.php
'timezone' => 'Asia/Shanghai',

这样 Carbon 解析时间字符串时，默认认为是北京时间。

3️⃣ 查询 ClickHouse 时，如果需要展示为本地时间

可选：在 SQL 中直接转为 Asia/Shanghai 方便可视化工具使用（如 DBeaver）：

SELECT
    last_threat_time,
    toTimeZone(last_threat_time, 'Asia/Shanghai') AS local_time
FROM hp_vpn_ids.threat_event

或在 Laravel 展示时转换：

Carbon::parse($utcTime)->setTimezone('Asia/Shanghai')->toDateTimeString();

🛠️ 补充命令（ClickHouse 排查时区问题）

SELECT timezone(); -- 显示当前 ClickHouse 时区（一般为 UTC）
SELECT now(), toTimeZone(now(), 'Asia/Shanghai');

❌ 不推荐的方案

🧭 总结

"ClickHouse 认 UTC，Laravel 用本地，写前转 UTC，读后转本地"