Gin框架如何以multipart/form-data格式发送下载文件

首先明确：Gin 内置的context.File()方法是单文件返回的便捷封装，默认固定返回application/octet-stream类型触发下载，本身不支持直接输出multipart/form-data格式响应。multipart/form-data是带分隔符的多段报文格式，需要手动构造符合规范的响应体，具体实现步骤如下：

• 提前生成全局唯一的boundary分隔字符串，保证不会和文件正文内容冲突
• 手动设置响应头Content-Type为multipart/form-data，同时携带上一步生成的boundary参数
• 基于响应写入器初始化multipart构造器，写入文件字段内容，如有需要可额外追加其他普通表单字段
• 完成写入后返回200状态码

完整代码示例 #

import (
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
    "time"
    "github.com/gin-gonic/gin"
)

func MultipartFileHandler(c *gin.Context) {
    // 替换为实际的本地文件路径和客户端展示的文件名
    targetFilePath := "./example.xlsx"
    downloadFileName := "业务数据导出.xlsx"

    // 生成随机boundary，避免和文件内容重复
    boundary := fmt.Sprintf("gin-mp-%d", time.Now().UnixNano())
    // 设置响应头，Content-Type必须和后续写入器使用的boundary完全一致
    c.Writer.Header().Set("Content-Type", "multipart/form-data; boundary="+boundary)

    // 初始化multipart写入器，绑定到当前响应的Writer
    mpWriter := multipart.NewWriter(c.Writer)
    defer mpWriter.Close()
    // 给写入器设置相同的boundary
    _ = mpWriter.SetBoundary(boundary)

    // 创建文件类型的表单字段
    fileFieldWriter, err := mpWriter.CreateFormFile("file", downloadFileName)
    if err != nil {
        c.String(http.StatusInternalServerError, "构造表单字段失败: %v", err)
        return
    }

    // 打开本地待返回的文件
    srcFile, err := os.Open(targetFilePath)
    if err != nil {
        c.String(http.StatusInternalServerError, "打开本地文件失败: %v", err)
        return
    }
    defer srcFile.Close()

    // 将文件内容拷贝到multipart字段中
    _, err = io.Copy(fileFieldWriter, srcFile)
    if err != nil {
        c.String(http.StatusInternalServerError, "写入文件内容失败: %v", err)
        return
    }

    // 如需同时返回其他表单字段，可直接调用WriteField追加，示例：
    // _ = mpWriter.WriteField("export_time", time.Now().Format(time.DateTime))
    // _ = mpWriter.WriteField("total_count", "128")

    c.Status(http.StatusOK)
}

常见场景简化方案 #

如果你只是想修改下载文件的MIME类型，不需要同时返回多段内容（多文件、文件+其他字段），完全没必要使用multipart/form-data格式，直接在调用context.File()前手动设置对应响应头即可，示例：

// 比如返回PNG图片，设置对应MIME
c.Header("Content-Type", "image/png")
// 配置为下载模式，指定文件名
c.Header("Content-Disposition", "attachment; filename=\"avatar.png\"")
c.File("./local-avatar.png")

只有需要在一次响应中同时返回多段独立内容时，才需要使用multipart格式。

内容的提问来源于stack exchange，提问作者Dev chimp