Golang Fiber中JSON数组无法绑定到结构体字段的问题求助

看起来你遇到的问题主要出在结构体标签配置和字段类型不匹配这两个核心点上，我来一步步帮你排查解决：

1. 核心问题分析 #

（1）缺少JSON字段映射标签 #

你第二次修改后的_inData结构体只给TagList加了form:"tag_list"标签，但你的请求是JSON格式（Content-Type为application/json）。Fiber的BodyParser会根据请求的Content-Type选择对应的解析规则：处理JSON时，它依赖json标签来做字段名映射，而非form标签。因为你的TagList字段没有json:"tag_list"标签，JSON中的tag_list字段无法和结构体的TagList字段匹配（默认大小写敏感），所以绑定结果为空。

（2）字段类型不匹配导致解析失败 #

你的MapTag结构体中Id是uint类型，但第一次发送的JSON里id是字符串值（"1"）。默认的JSON解析器（Fiber底层基于encoding/json）无法直接将字符串转换为uint类型，这会导致单个MapTag元素解析失败，进而整个TagList数组绑定为空。即使第二次你发送了数字类型的id，如果标签配置不对，依然会有问题。

2. 具体解决方案 #

步骤1：修正结构体的JSON标签 #

确保_inData的TagList字段同时保留json和form标签，适配不同的请求类型：

type _inData struct {
    Title    string          `json:"title" form:"title"`
    TagList  []model.MapTag `json:"tag_list" form:"tag_list"` // 必须添加json标签
}

步骤2：兼容字符串/数字类型的ID字段 #

修改MapTag的Id字段标签，让JSON解析器能自动将字符串类型的id转换为uint：

type MapTag struct {
    Id        uint      `json:"id,string" form:"id" xorm:"bigint unsigned pk autoincr"` 
    // 加上`,string`标签后，既支持JSON数字，也支持JSON字符串转uint
    TagName   string    `json:"tag_name" form:"tag_name" xorm:"index"`
    CreatedAt time.Time `json:"created_at" form:"created_at" xorm:"timestamp created"`
    UpdatedAt time.Time `json:"updated_at" form:"updated_at" xorm:"timestamp updated"`
}

步骤3：添加错误捕获排查问题 #

在解析时一定要检查BodyParser的错误，这能帮你快速定位具体的解析问题（比如类型不匹配、格式错误）：

inData := new(_inData)
if err := c.BodyParser(inData); err != nil {
    log.Printf("请求体解析错误: %v", err)
    return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{
        "error": "请求格式错误: " + err.Error(),
    })
}
fmt.Printf("解析结果: %+v\n", inData)

3. 额外验证点 #

• 确认Flutter端发送的tag_list结构正确：每个元素的键名是id和tag_name，和结构体的JSON标签完全一致；
• 确保请求的Content-Type确实是application/json：你的Flutter代码里已经设置了，但可以抓包验证一下，避免dio自动修改请求头（比如如果发送FormData的话会自动切换，但你注释了file字段，应该没问题）。

按照这些步骤修改后，应该就能成功绑定TagList数组了。

内容的提问来源于stack exchange，提问作者Choi yun seok