GORM的gorm:"type"标签需显式指定PostgreSQL精度,如numeric(12,2);bson标签冒号后禁空格;Scany扫描NULL须用string或sql.Null;结构体字段必须导出才能被GORM/Scany/JSON使用。

gorm:"type" 标签必须显式指定 PostgreSQL 数值精度
PostgreSQL 的 numeric、decimal、timestamp 等类型默认不带精度时,GORM 会映射为无约束的列(如 numeric 而非 numeric(10,2)),导致插入超长小数被截断或时间精度丢失。这不是 bug,而是 GORM 的默认行为。
解决方式是强制用 gorm:"type" 标签覆盖默认映射:
-
Amount float64 `gorm:"type:numeric(12,2)"`—— 确保金额最多 12 位,含 2 位小数 -
CreatedAt time.Time `gorm:"type:timestamp with time zone"`—— 显式启用时区支持,避免 UTC 与本地时间混淆 -
Status string `gorm:"type:varchar(20)"`—— 防止长文本意外写入,同时提升索引效率
⚠️ 注意:type 标签会完全跳过 GORM 的自动类型推导,所以必须写全 PostgreSQL 原生语法,不能写 gorm:"type:decimal(10,2)" 这种非标准写法(PostgreSQL 不认 decimal 别名,只认 numeric)。
bson 字段名空格会导致 MongoDB 反序列化失败
mgo(及部分旧版 mongo-go-driver 兼容层)对 bson 标签格式极其敏感:只要 bson: 后面多一个空格,整个标签就被视为无效,字段退回到按 Go 字段名(如 Title)严格匹配 MongoDB 键名(如 title),结果永远是零值。
立即学习“go语言免费学习笔记(深入)”;
常见错误写法:
type News struct {
Title string `bson:"title" json:"title"` // ❌ 冒号后有空格
}
正确写法(无空格、无换行、引号紧贴):
type News struct {
ID bson.ObjectId `bson:"_id"`
Title string `bson:"title"` // ✅
TimeStamp string `bson:"timeStamp"` // ✅ 匹配数据库中的 "timeStamp"
MainStory string `bson:"mainStory"` // ✅
}
这个空格问题在代码合并或格式化后极易复现,建议用静态检查工具(如 revive)加自定义规则扫描 bson: 后空白。
Scany 扫描 NULL 值必须用指针或 sql.Null* 类型
当数据库列允许为 NULL,而你用普通 Go 类型(如 string、int)接收时,Scany 会直接 panic 或静默忽略该行——它不会帮你做空值适配。
必须显式声明可空类型:
-
Name *string—— 最简方案,nil表示 NULL,非nil表示有值 -
Age sql.NullInt64—— 更安全,自带Valid字段判断是否为 NULL -
CreatedAt *time.Time—— 时间字段同理,否则遇到 NULL 会触发parse time错误
Scany 不会自动把 string 转成 *string,这点和 GORM 不同。结构体定义即契约,错一个字段类型,整行扫描就失败。
Go 结构体字段必须导出才能被 GORM / Scany / JSON 使用
所有数据库映射库(GORM、Scany)、JSON 序列化器都依赖反射读取字段值。而 Go 规定:只有首字母大写的导出字段才能被其他包访问。如果你写:
type User struct {
id int `gorm:"column:user_id"`
name string `gorm:"column:user_name"`
}
那么 GORM 会完全看不到 id 和 name,操作全部静默失败(比如 Create 插入全 NULL,Find 返回空结构体)。
正确做法是字段名导出 + 标签指定底层列名:
type User struct {
ID int `json:"user_id" gorm:"column:user_id;primaryKey"`
Name string `json:"user_name" gorm:"column:user_name"`
}
别试图靠标签“绕过”导出规则——反射层面就不可见,标签再全也没用。这是编译期限制,不是运行时配置问题。


















