Go 使用 go-sql-driver/mysql 向 MySQL 插入本地时间时，因驱动默认将 time.Time 转为 UTC 再发送，而数据库未配置对应时区，导致存储时间比预期快/慢若干小时。根本原因在于驱动时区配置缺失与数据库时区不一致。
go 使用 `go-sql-driver/mysql` 向 mysql 插入本地时间时，因驱动默认将 `time.time` 转为 utc 再发送，而数据库未配置对应时区，导致存储时间比预期快/慢若干小时。根本原因在于驱动时区配置缺失与数据库时区不一致。
在 Go 应用中操作 MySQL 时，time.Now().Local() 获取的本地时间（如 UTC+3）被 go-sql-driver/mysql 驱动自动转换为 UTC 时间后再写入数据库——这是驱动的默认行为。即使你的机器、Go 进程和 MySQL 服务均运行在相同本地时区（如 Europe/Istanbul），若未显式配置驱动时区，它仍会以 time.UTC 为基准进行序列化，最终导致数据库中存储的时间比实际本地时间早 3 小时（即 2016-11-07 19:51:02 而非 22:51:02）。
✅ 正确做法：显式配置驱动时区
在构建 MySQL 数据库连接 DSN（Data Source Name）时，必须通过 loc 参数指定时区，例如：
import (
"database/sql"
_ "github.com/go-sql-driver/mysql"
"time"
)
func connectDB() (*sql.DB, error) {
// 方式一：使用 time.Local（推荐用于开发/单时区环境）
dsn := "user:password@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local"
// 方式二：显式指定 IANA 时区名（生产环境更可靠）
// dsn := "user:password@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Europe%2FIstanbul"
db, err := sql.Open("mysql", dsn)
if err != nil {
return nil, err
}
return db, nil
}⚠️ 注意事项：
-
parseTime=true是必需参数，否则驱动不会解析time.Time类型字段； -
loc=Local表示使用 Go 进程启动时的本地时区（由time.Local确定），但依赖宿主机TZ环境变量或系统时区设置； - 更健壮的做法是使用 IANA 时区名（如
loc=Europe%2FIstanbul），避免因部署环境差异导致time.Local解析错误； - URL 编码：空格和
/需编码（/→%2F），可使用url.QueryEscape("Europe/Istanbul")生成。
? 推荐架构：统一使用 UTC 存储（最佳实践）
虽然配置 loc=Local 可快速修复当前问题，但长期来看，强烈建议所有时间字段在数据库中统一存储为 UTC：
- MySQL 服务器应设置
default-time-zone='+00:00'（或UTC）； - Go 代码中始终使用
time.Now().UTC()构造时间值； - 展示层（API 响应、Web 页面）再按需转换为用户本地时区。
// ✅ 推荐：入库前转为 UTC
app_log.CreatedDate = time.Now().UTC()
// ✅ 查询后按需格式化为本地时间（如日志展示）
fmt.Println(app_log.CreatedDate.In(time.Local).Format("2006-01-02 15:04:05"))这样做的优势包括：
- 消除跨时区部署（如容器、云函数）的时区歧义；
- 简化时间计算（如“过去 24 小时”无需考虑夏令时）；
- 避免
NOW()与应用写入时间因时区配置不一致而错位； - 符合 RFC 3339 和云原生应用设计规范。
? 验证与调试技巧
- 检查 MySQL 当前时区：
SELECT @@global.time_zone, @@session.time_zone; - 查看驱动是否启用
parseTime：DSN 中必须含parseTime=true； - 打印驱动实际发送的时间（调试用）：
log.Printf("Writing time: %+v (loc=%s)", t, t.Location()) // 确认是否已为 Local/UTC
总结：Go MySQL 驱动的时间偏差本质是时区协商缺失。临时方案是 DSN 加 loc=Local；长期方案是全链路标准化为 UTC —— 既提升健壮性，也降低运维复杂度。
