Echo框架表单多层数组绑定到struct结构体返回空数组如何解决

问题原因与解决方案 #

1 首要错误：结构体标签不匹配

你代码中Pages数组内的Order字段form标签误写为form:"title"，和提交的参数名pages[0][order]完全不匹配，这是绑定失败的核心原因。

首先修正结构体定义：

type _getData struct {
    Title string `json:"title" form:"title"`
    Date  string `json:"date" form:"date"`
    Pages []struct {
        // 修正form标签为对应的order字段
        Order       int    `json:"order" form:"order"`
        Description string `json:"description" form:"description"`
    } `json:"pages" form:"pages"`
}

修正后重新调用c.Bind(&getData)，Echo v4.0+版本默认已经支持pages[0][order]格式的表单参数绑定，大部分场景下可以直接拿到正确的Pages数组。

2 旧版本Echo兼容方案

如果你使用的是低于v4.0的Echo版本，默认绑定器不支持多层嵌套数组的索引式参数解析，可以手动从已获取的FormParams中组装数据，代码示例如下：

import (
    "strings"
    "strconv"
    "github.com/labstack/echo/v4"
)

func CreateDiary(c echo.Context) error {
    var getData _getData
    // 先绑定顶层非嵌套字段
    if err := c.Bind(&getData); err != nil {
        return c.JSON(400, map[string]string{"msg": "参数错误"})
    }
    // 获取所有表单参数
    formParams, err := c.FormParams()
    if err != nil {
        return err
    }

    // 按索引分组解析pages参数
    pagesMap := make(map[int]map[string]string)
    for paramKey, paramVals := range formParams {
        if !strings.HasPrefix(paramKey, "pages[") || len(paramVals) == 0 {
            continue
        }
        // 提取数组索引和字段名
        idxEnd := strings.Index(paramKey, "]")
        if idxEnd == -1 {
            continue
        }
        idxStr := strings.TrimPrefix(paramKey[:idxEnd], "pages[")
        idx, err := strconv.Atoi(idxStr)
        if err != nil {
            continue
        }
        fieldName := strings.Trim(paramKey[idxEnd+1:], "[]")

        if _, ok := pagesMap[idx]; !ok {
            pagesMap[idx] = make(map[string]string)
        }
        pagesMap[idx][fieldName] = paramVals[0]
    }

    // 组装到结构体的Pages字段
    getData.Pages = make([]struct {
        Order       int    `json:"order" form:"order"`
        Description string `json:"description" form:"description"`
    }, 0, len(pagesMap))
    for i := 0; i < len(pagesMap); i++ {
        pageItem, ok := pagesMap[i]
        if !ok {
            continue
        }
        order, _ := strconv.Atoi(pageItem["order"])
        getData.Pages = append(getData.Pages, struct {
            Order       int    `json:"order" form:"order"`
            Description string `json:"description" form:"description"`
        }{
            Order:       order,
            Description: pageItem["description"],
        })
    }

    fmt.Print(getData)
    // 后续业务逻辑
    return nil
}

注意事项

如果提交的是multipart/form-data类型的带文件表单，需要先调用c.Request().ParseMultipartForm(32 << 20)（32M为最大内存限制，可自行调整）后再执行参数解析。

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