最安全做法是用 json.RawMessage 接收未知结构 JSON 字段，因其为 []byte 别名，仅字节搬运、绕过类型校验，避免反序列化失败、字段丢失、类型冲突和 panic；需配合 GORM tag type:json 及空值判别。
直接用 string 或 []byte 接收未知结构的 JSON 字段最安全，避免反序列化失败、类型冲突和 panic。GORM 本身不校验 JSON 内容合法性，但 Go 层若强行映射到结构体，一碰到字段缺失、类型错位（如预期 int 实际是 string）就会崩溃。
为什么不能直接用结构体接收动态 JSON 字段
当你不确定数据库中 JSON 字段的实际结构（比如 metadata 可能今天存 {"theme":"dark"}，明天变成 {"theme":"dark","prefs":{"lang":"zh","notify":true}}），硬写一个 Go 结构体去绑定会导致：
-
json.Unmarshal失败时返回 error，但 GORM 默认忽略该 error，静默设为零值 —— 你拿到的是空结构体，却不知道数据丢了 - 字段名大小写不一致（如 DB 存
"Theme"，结构体写Theme string但标签漏了json:"Theme"）→ 字段不填充 - 同一字段在不同行中类型漂移（
"score"有时是int，有时是float64或null）→ 强制映射必 panic - GORM v2 在使用
datatypes.JSON时虽自动处理[]byte↔json.RawMessage，但它仍要求你后续手动解析；若直接嵌套结构体，问题照旧
推荐做法：用 json.RawMessage 延迟解析
json.RawMessage 是 []byte 的别名，不做任何解析，只做字节搬运，完全绕过 Go 类型系统校验。它是最轻量、最可控的“占位符”方案。
示例结构体定义：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
type User struct {
ID int `gorm:"primaryKey"`
Name string `gorm:"not null"`
Metadata json.RawMessage `gorm:"column:metadata;type:json"`
}
查询后按需解析：
var u User
db.First(&u)
// 安全解析，可捕获具体错误
var meta map[string]interface{}
if err := json.Unmarshal(u.Metadata, &meta); err != nil {
log.Printf("invalid metadata JSON for user %d: %v", u.ID, err)
meta = map[string]interface{}{} // fallback
}
fmt.Println(meta["theme"]) // 不会 panic
- 即使
u.Metadata是null（数据库存 NULL），json.Unmarshal会成功，meta为nil，可统一判空处理 - 字段缺失、类型混杂、嵌套深度变化 —— 全部由你控制解析逻辑，不被 GORM 绑定流程劫持
- 性能开销最小：无冗余拷贝，无反射解析，仅一次内存读取
进阶：配合 GORM 的 JSON 查询能力做条件过滤
你不需要把整个 JSON 拿出来再用 Go 过滤。PostgreSQL/MySQL 原生支持 JSON 路径查询，GORM 提供了封装：
- PostgreSQL：
db.Where("metadata @> ?", `{"theme":"dark"}`)或更精确地db.Where("metadata->>'theme' = ?", "dark") - MySQL：
db.Where("JSON_EXTRACT(metadata, '$.theme') = ?", "dark") - GORM v2 内置辅助（需导入
gorm.io/datatypes）：db.Where(datatypes.JSONQuery("metadata").Equals("dark", "theme"))
注意：json.RawMessage 字段本身不参与这些查询 —— 查询走的是 SQL 层，你只需确保字段在数据库中是 JSON 或 JSONB 类型，并在 GORM tag 中声明 type:json 即可。
容易被忽略的关键点
很多人以为 “用了 json.RawMessage 就万事大吉”，但实际部署时仍翻车，原因常是：
- 忘记在 GORM tag 中加
type:json，导致 PostgreSQL 报错cannot cast type text to json；MySQL 则可能静默转成字符串 - 字段允许 NULL，但代码里直接
json.Unmarshal(u.Metadata, &x)—— 若u.Metadata == nil（对应 DB NULL），会 panic；必须先判空或用len(u.Metadata) > 0 - 误把
json.RawMessage当作可修改对象：它只是字节切片，u.Metadata = append(u.Metadata, '"')会破坏原始 JSON 合法性，写回数据库前务必重新验证 - 日志打印时直接
fmt.Printf("%s", u.Metadata)—— 若含二进制或未转义字符，可能污染日志；建议用string(u.Metadata)+strings.ReplaceAll清理控制字符
