parseTime=true 和 loc=Local 必须同时配置在 DSN 中,否则 time.Time 字段读取为零值或 panic;主键字段名必须为 ID 且类型为整型;sql.Open 后须调用 db.Ping() 验证连接。

parseTime=true 和 loc=Local 必须同时出现在 DSN 中,否则 time.Time 字段读出来大概率是 0001-01-01 00:00:00 +0000 UTC 或直接 panic。
DSN里漏掉parseTime=true&loc=Local,时间字段就废了
MySQL 的 DATETIME 字段默认以字符串形式返回,Go 的 time.Time 不会自动解析。GORM 不报错,但字段值永远是零值。
-
parseTime=true:让 MySQL 驱动把时间字符串转成time.Time类型 -
loc=Local(或loc=Asia%2FShanghai):指定时区,避免时间被当成 UTC 偏移 - 两者缺一不可——只设
parseTime=true但没设loc,Go 会按 UTC 解析,本地时间就差 8 小时 - DSN 示例:
root:pass@tcp(127.0.0.1:3306)/test?charset=utf8mb4&parseTime=true&loc=Local
sql.Open 必须先跑一遍,别直接扔给 gorm.Open
gorm.Open 对底层驱动错误不敏感,比如账号错、端口不通、数据库不存在,它可能静默返回 *gorm.DB 实例,后续查询才爆错。
- 正确做法:先用
sql.Open("mysql", dsn)获取*sql.DB,再调db.Ping()测试连通性 - 失败时立刻返回 error,而不是等到第一次
db.First()才发现连不上 - 注意:
sql.Open不真正建连,Ping()才触发连接校验 - 环境变量拼接 DSN 更安全,比如从
DB_USER、DB_ADDR拼出完整串,避免硬编码
主键必须叫 ID,且类型得是整数
Create() 后 ID 还是 0?不是数据库问题,是结构体没满足 GORM 约定。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 字段名必须是
ID(首字母大写),小写id不会被识别为主键 - 类型只能是整型:
int、int64、uint、uint32等;string或uuid.UUID需显式配置primaryKey标签 - 非空字段(如
NOT NULL)对应 struct 字段不能为零值,比如string是"",GORM 默认跳过该字段插入 - 想强制插入空字符串,得加标签:
gorm:"default:''"或显式.Select("Name")
First() 和 Take() 别混用,错误处理逻辑完全不同
两者都“取一条”,但语义和错误返回完全相反,线上容易掩盖 bug。
-
First():按条件查,找不到返回gorm.ErrRecordNotFound,可明确判断“无数据” -
Take():只取结果集第一行,哪怕WHERE id = 999没匹配到,也返回nilerror 和空 struct - 误用
Take()替代First()会导致逻辑分支失效,比如本该跳过处理的场景,却继续执行了 - 建议:主键查询用
First(),分页取首条或聚合后取一行用Take()
时区和时间解析是高频踩坑点,但真正麻烦的是——这些参数不出错时不报警,出错时又不报具体哪错了。parseTime 和 loc 必须一起配,ID 字段大小写必须对,sql.Open 必须提前验证,这三件事少做一件,后面查半天都找不到根因。










