插入结构体数组至数据库时触发「Row value misused」错误求助

错误原因 #

你遇到的「row value misused」错误，核心问题是GORM生成的SQL把img_files数组的两个元素当成了**行值（多列数据）**传递给单个字段：

INSERT INTO employees_details (img_uid, img_files) 
VALUES 
  (
    "asfe123y3uygy43", 
    (
      "{...}",  -- 这里把两个JSON字符串用括号包裹，被数据库识别为多列值
      "{...}"
    )
  )

而你的img_files字段是用来存储结构体数组的单个JSON类型字段，数据库期望接收的是单个JSON数组字符串，不是多个独立JSON值组成的行结构。

解决步骤 #

1. 修正结构体的GORM标签 #

确保img_files字段在结构体里明确标记为JSON类型，让GORM自动将数组序列化为单个JSON字符串：

type EmployeeDetail struct {
    ImgUID    string        `gorm:"column:img_uid"`
    ImgFiles  []ImgFile     `gorm:"column:img_files;type:json"` // 关键：指定字段类型为json
}

type ImgFile struct {
    ImageID   string `json:"ImageID"`
    ImageType string `json:"ImageType"`
    MediaType string `json:"MediaType"`
    MediaPath string `json:"MediaPath"`
}

2. 手动序列化兜底（若自动序列化失效） #

如果标签配置后问题依旧，可以手动将数组序列化为JSON字符串再插入：

import "encoding/json"

// 先把结构体数组转成JSON字符串
imgFilesJSON, err := json.Marshal(yourImgFilesArray)
if err != nil {
    // 处理序列化错误
}

// 方式1：用结构体插入（确保ImgFiles字段能正确解析JSON字符串）
employeeDetail := EmployeeDetail{
    ImgUID:   "asfe123y3uygy43",
    ImgFiles: imgFilesJSON, // 若结构体字段类型为[]byte，直接传入；若为string则转成string类型
}
db.Create(&employeeDetail)

// 方式2：用原生SQL直接插入，避免GORM自动处理的问题
db.Exec("INSERT INTO employees_details (img_uid, img_files) VALUES (?, ?)", "asfe123y3uygy43", string(imgFilesJSON))

3. 确认数据库字段类型 #

检查employees_details表的img_files字段类型是否为JSON/JSONB（比如PostgreSQL的jsonb、MySQL的json），如果是普通字符串类型（如varchar），即使传入正确的JSON字符串也可能引发解析问题。

正确的SQL示例 #

最终生成的合法SQL应该是将整个数组序列化为单个JSON字符串：

INSERT INTO employees_details (img_uid, img_files) 
VALUES 
  (
    "asfe123y3uygy43", 
    "[
      {\"ImageID\":\"ISDx-Y0fudfhv4lC_M25j\",\"ImageType\":\"original\",\"MediaType\":\"img/png\",\"MediaPath\":\"it-profile/faergbgbder34fgb/original/154895123-owen.png\"},
      {\"ImageID\":\"fgsrtbrdsthrb\",\"ImageType\":\"thumbnail\",\"MediaType\":\"img/png\",\"MediaPath\":\"it-profile/faergbgbder34fgb/thumb/154895123-owen.png\"}
    ]"
  )

内容的提问来源于stack exchange，提问作者Mike Abbey