如何通过GORM对Postgres JSONB列指定字段执行Upsert操作

数据老陈

2026-6-23

解决Postgres + GORM Upsert时仅更新JSONB特定字段的问题

要实现仅更新Code列和Data（jsonb类型）中的instance、system字段，不能直接用AssignmentColumns（它会替换整个Data列），需要借助Postgres的JSONB函数，结合GORM的自定义赋值表达式来实现：

方案一：使用`jsonb`合并操作符`||`

这种方式通过合并原有JSONB数据和新的指定字段，保留原有字段（比如name），仅更新目标字段：

// 假设你的模型结构体定义如下
type Project struct {
    Id     int            `gorm:"primaryKey"`
    Code   string
    Data   json.RawMessage `gorm:"type:jsonb"` // 或使用gorm.JSONB标签
}

// Upsert逻辑
db.Clauses(clause.OnConflict{
    Columns: []clause.Column{{Name: "Id"}}, // 冲突判定字段：Id
    DoUpdates: clause.Assignments(map[string]interface{}{
        "Code": gorm.Expr("EXCLUDED.Code"), // 更新Code为待插入的新值
        // 合并原有Data与新的instance、system字段，保留其他原有字段
        "Data": gorm.Expr("Data || jsonb_build_object('instance', EXCLUDED.Data->>'instance', 'system', EXCLUDED.Data->>'system')"),
    }),
}).CreateInBatches(&projects, 3000).Error

方案二：使用`jsonb_set`函数

如果需要更精确的字段路径控制（比如嵌套字段），可以用jsonb_set逐层设置目标字段：

db.Clauses(clause.OnConflict{
    Columns: []clause.Column{{Name: "Id"}},
    DoUpdates: clause.Assignments(map[string]interface{}{
        "Code": gorm.Expr("EXCLUDED.Code"),
        // 依次设置instance和system字段
        "Data": gorm.Expr("jsonb_set(jsonb_set(Data, '{instance}', EXCLUDED.Data->'{instance}'), '{system}', EXCLUDED.Data->'{system}')"),
    }),
}).CreateInBatches(&projects, 3000).Error

关键说明

EXCLUDED是Postgres Upsert机制中的特殊虚拟表，代表当前待插入的那条记录，用来获取新的字段值。
两种方案都会保留Data中原有的name字段，仅更新指定的instance和system。
确保你的模型中Data字段的类型与Postgres的jsonb正确映射，比如使用json.RawMessage或带gorm:"type:jsonb"标签的map[string]interface{}。