Go Gin项目中Postman Form-data上传文件+JSON数据的问题排查

为啥会踩坑？ #

你用c.ShouldBindJSON()或者json.NewDecoder去解析Form-data请求体，肯定会出EOF错误——因为Form-data是multipart格式，不是纯JSON。后来改代码结构体还是空的，大概率是没正确处理Form-data里的JSON字段绑定，或者请求体被重复读取了。

直接上可行方案 #

1. 先定义接收结构体 #

把你要存的Blob元数据结构体写好，记得同时加form标签（对应Form-data里的字段名）：

type BlobMetadata struct {
    ContainerName string `json:"container_name" form:"container_name"`
    // 其他字段比如描述、分类啥的，按需添加
}

2. 写正确的Gin Handler #

别混用JSON解析和Form-data读取，按这个步骤来：

func UploadBlobHandler(c *gin.Context) {
    // 第一步：先获取上传的文件
    file, err := c.FormFile("file")
    if err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": "获取文件失败: " + err.Error()})
        return
    }

    // 第二步：获取Form-data里的JSON字段（比如字段名叫metadata）
    metadataStr := c.PostForm("metadata")
    if metadataStr == "" {
        c.JSON(http.StatusBadRequest, gin.H{"error": "metadata不能为空"})
        return
    }

    // 第三步：把JSON字符串解析到结构体
    var metadata BlobMetadata
    err = json.Unmarshal([]byte(metadataStr), &metadata)
    if err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": "解析metadata出错: " + err.Error()})
        return
    }

    // 第四步：生成UUID当Blob名（沿用你原来的逻辑）
    blobName := uuid.NewString() + filepath.Ext(file.Filename)

    // 第五步：上传到Azure（用你已有的代码即可）
    // uploadToAzure(metadata.ContainerName, blobName, file)

    // 第六步：插入数据库（把blobName、容器名等数据存进去）
    // insertBlobRecord(blobName, metadata.ContainerName, ...)

    c.JSON(http.StatusOK, gin.H{
        "msg": "上传成功",
        "blob_name": blobName,
        "metadata": metadata,
    })
}

3. Postman配置要点 #

• 请求方法选POST
• Body选Form-data
  • 添加键file，类型选File，选择要上传的文件
  • 添加键metadata，类型选Text，填入合法JSON字符串，比如：

    {"container_name": "my-test-container"}
    

4. 避坑关键 #

• 绝对别混用c.ShouldBindJSON()和c.FormFile()/c.PostForm()：前者会把整个请求体读完，后者再读就会触发EOF错误。
• 字段名完全匹配：Postman里的键名、代码里的form标签、JSON键名要严格对应，大小写敏感！
• 检查JSON格式：少引号、错逗号都会导致解析失败，先复制JSON去在线校验工具确认格式合法。

备选：复合结构体绑定（不如手动解析靠谱） #

如果你想试试Gin的自动绑定，可以定义包含文件和元数据字符串的结构体，但还是得手动解析JSON：

type UploadRequest struct {
    File *multipart.FileHeader `form:"file" binding:"required"`
    MetadataStr string `form:"metadata" binding:"required"`
}

// Handler里使用：
var req UploadRequest
if err := c.ShouldBind(&req); err != nil {
    c.JSON(http.StatusBadRequest, gin.H{"error": "绑定请求数据失败: " + err.Error()})
    return
}
var metadata BlobMetadata
json.Unmarshal([]byte(req.MetadataStr), &metadata)

排查小技巧 #

• 先打印metadataStr看看有没有拿到值，为空就是Postman字段名写错了。
• 打印解析后的metadata结构体，看哪个字段没填充，检查JSON键名和结构体标签是否一致。

内容的提问来源于stack exchange，提问作者Guilherme Rodrigues