如何使用GORM向PostgreSQL的JSONB字段插入map[string]类型数据

该报错是因为GORM原生不支持自定义map类型到PostgreSQL JSONB类型的自动序列化/反序列化，仅标注sql:"type:JSONB"标签不会触发自动JSON转换。另外你示例中调用db.Create(&World{})存在实例类型错误：World结构体没有Worlds字段，需要操作的是Huygens结构体实例。

方案一：自定义map类型实现GORM的Valuer/Scanner接口（推荐，类型安全） #

提前导入encoding/json、database/sql/driver、errors、fmt等依赖包，修改结构体定义并实现接口方法：

// 自定义map类型替换原生map定义
type WorldMap map[string]World

type Huygens struct {
    // 优先使用gorm标签，避免版本兼容问题
    Worlds WorldMap `json:"worlds" gorm:"type:JSONB"`
}

type World struct {
    Diameter int
    Name string
}

// Value 实现Valuer接口，序列化存入数据库时调用
func (w WorldMap) Value() (driver.Value, error) {
    return json.Marshal(w)
}

// Scan 实现Scanner接口，从数据库读取反序列化时调用
func (w *WorldMap) Scan(value interface{}) error {
    bytes, ok := value.([]byte)
    if !ok {
        return errors.New(fmt.Sprint("Failed to unmarshal JSONB value:", value))
    }
    return json.Unmarshal(bytes, w)
}

插入数据直接操作Huygens实例即可：

h := Huygens{
    Worlds: WorldMap{
        "earth": {Diameter: 12742, Name: "Earth"},
        "mars": {Diameter: 6779, Name: "Mars"},
    },
}
if err := db.Create(&h).Error; err != nil {
    // 错误处理逻辑
}

方案二：使用GORM官方datatypes.JSON类型（无需手动实现接口） #

先导入官方数据类型包：import "gorm.io/datatypes"，修改结构体定义：

type Huygens struct {
    Worlds datatypes.JSON `json:"worlds" gorm:"type:JSONB"`
}

插入前手动把map序列化为JSON再赋值：

worlds := map[string]World{
    "earth": {Diameter: 12742, Name: "Earth"},
    "mars": {Diameter: 6779, Name: "Mars"},
}
worldsJson, _ := json.Marshal(worlds)
h := Huygens{
    Worlds: worldsJson,
}
db.Create(&h)

该方案缺点是读取数据时需要手动反序列化为对应map类型，无编译期类型校验。

• 确保PostgreSQL表对应的worlds字段类型为JSONB
• 优先使用gorm:"type:JSONB"标签，避免旧版本GORM不识别sql标签

内容的提问来源于stack exchange，提问作者Eugene mtl