MySQL 数据时间时区差异问题分析

问题原因

当使用 Prisma 操作 MySQL 数据库时出现时间时区差异，通常由以下几个因素导致：

1. 数据库服务器时区设置：MySQL 服务器配置的时区
2. 连接时区设置：JDBC/连接字符串中的时区参数
3. 应用服务器时区：运行 Prisma 的服务器的系统时区
4. Prisma 客户端处理：Prisma 如何处理和转换时间数据

解决方案

1. 统一时区配置

在 Prisma 连接字符串中明确指定时区：

datasource db {
  provider = "mysql"
  url      = "mysql://user:password@localhost:3306/db?connection_limit=5&timezone=UTC"
}

或使用其他标准时区如 Asia/Shanghai。

2. 数据库层面设置

确保 MySQL 服务器时区设置一致：

-- 查看当前时区设置
SELECT @@global.time_zone, @@session.time_zone;

-- 设置为UTC时区
SET GLOBAL time_zone = '+00:00';
SET time_zone = '+00:00';

3. Prisma 模型定义

在 Prisma 模型中使用适当的日期时间类型：

model Event {
  id        Int      @id @default(autoincrement())
  createdAt DateTime @default(now()) @db.Timestamp(6)
  updatedAt DateTime @updatedAt @db.Timestamp(6)
  eventTime DateTime @db.Timestamp(6)
}

4. 应用层处理

在应用代码中统一时区处理：

// 使用UTC时间处理
const utcDate = new Date().toISOString();

// 或者在查询时转换时区
const events = await prisma.$queryRaw`
  SELECT id, CONVERT_TZ(eventTime, 'UTC', 'Asia/Shanghai') as localEventTime
  FROM Event
`;

最佳实践

1. 推荐使用UTC存储：在数据库中始终以UTC时间存储，在应用层按需转换
2. 环境一致性：确保开发、测试和生产环境的时区设置一致
3. 文档记录：在项目文档中明确记录时区处理策略

调试技巧

如果问题仍然存在，可以添加以下调试步骤：

1. 直接查询数据库验证原始存储的时间值
2. 检查 Prisma 查询日志中的实际SQL语句
3. 比较应用服务器、数据库服务器和客户端的当前时间

通过以上方法，您应该能够解决 Prisma 操作 MySQL 时的时间时区差异问题。