Go-Gin一对多关系模型下JSON数据绑定的最佳实践咨询

问题根因 #

你当前的报错有两个原因：

1. 入参绑定方法传值错误：context.ShouldBindJSON(product)需要传入结构体指针，正确写法是context.ShouldBindJSON(&product)，否则无法把解析后的值写入结构体。
2. 字段类型不匹配：Product模型的Media字段是[]Media结构体数组，但请求体里的media是纯字符串数组，JSON反序列化无法直接将字符串转为Media结构体，所以抛出类型不匹配错误。

最佳实践方案 #

推荐使用「DTO（数据传输对象）分层+类型转换」的方案，把接口入参结构和数据库模型完全解耦，避免业务逻辑和底层存储绑定：

1. 定义接口入参结构体 #

// CreateProductRequest 新建产品接口的请求参数结构
type CreateProductRequest struct {
    Name  string   `json:"name" binding:"required"`
    Media []string `json:"media" binding:"required,min=1"`
}

2. 绑定入参后转换为数据库模型 #

// 绑定请求参数到DTO
var req CreateProductRequest
if err := context.ShouldBindJSON(&req); err != nil {
    context.String(http.StatusBadRequest, fmt.Sprintf("err: %s", err.Error()))
    return
}

// 转换DTO为数据库模型
product := Product{
    Name: req.Name,
}
// 批量转换media字符串为Media结构体
for _, uri := range req.Media {
    product.Media = append(product.Media, Media{
        URI: uri,
    })
}

// 插入数据，gorm会自动关联写入Media表并填充ProductID外键
tx := DB.Create(&product)
if tx.Error != nil {
    context.String(http.StatusBadRequest, fmt.Sprintf("err: %s", tx.Error))
    return
}

方案优势 #

• 接口入参和数据库模型完全解耦，任意一侧改动不会影响另一侧
• 可以灵活为入参添加校验规则，比如上面的required、min=1限制media字段不能为空
• 扩展方便，后续如果要对media做预处理（比如URI格式校验、去重、资源格式判断），直接在转换环节添加逻辑即可

不推荐的替代方案 #

你也可以给Media结构体实现json.Unmarshaler接口，让它支持直接从字符串反序列化，但这种方式会把JSON序列化逻辑和数据库模型绑定，污染模型定义，后续其他场景序列化Media结构体时可能出现逻辑冲突，因此不建议使用。

内容的提问来源于stack exchange，提问作者Ayad Salim