Gin怎么解决上传中文文件名出现的乱码问题-Golang-PHP中文网

正确获取中文文件名需跳过默认解析，手动读取原始content-disposition头并按rfc 5987解码；或前端用encodeuricomponent编码、后端url.pathunescape解码；禁用c.formfile()是关键。

gin怎么解决上传中文文件名出现的乱码问题

为什么上传中文文件名会乱码 HTTP 协议本身不规定 multipart/form-data 中 filename 的编码方式，各浏览器自行实现：Chrome 用 UTF-8 原样传（但可能被 Go 的 `multipart.Reader` 解析为 Latin-1）、Firefox 会做 RFC 5987 编码、Safari 则可能截断或丢弃非 ASCII 字符。Gin 的 `c.FormFile()` 底层调用 `http.Request.MultipartReader()`，它默认把 `filename` 字段当作 ISO-8859-1 解码——遇到中文就变成乱码字节，比如 `"æµè¯.txt"`。

这不是 Gin 的 bug，而是 HTTP 表单规范的历史包袱。你拿到的 *multipart.FileHeader.Filename 已经是错的，后续再转码也晚了。

上传时怎么拿到正确的中文文件名关键不是“解码”，而是跳过默认解析，手动读取原始 header 字段。Gin 不提供直接访问原始 multipart boundary 数据的接口，所以得退回到 `c.Request` 层：

禁用 Gin 自动 multipart 解析：启动时设 `r.MaxMultipartMemory = 0`，避免 `c.FormFile()` 提前触发错误解码

用 `c.Request.MultipartReader()` 手动遍历 part，检查 `part.Header.Get("Content-Disposition")`

从该 header 字符串里正则提取 `filename\*=(.+?)''(.+)`（RFC 5987 格式）或 fallback 的 `filename="(.+)"`

对提取出的值用 `url.PathEscape()` 反向解码（注意：不是 `url.QueryEscape()`，它会把 `+` 当空格处理）

示例片段：

AI Short

AI Short是一款AI提示词工具，AI提示词管理和共享平台，多种场景的快捷指令。

下载

reader, _ := c.Request.MultipartReader()
for {
    part, err := reader.NextPart()
    if err == io.EOF {
        break
    }
    if part.FormName() == "file" {
        cd := part.Header.Get("Content-Disposition")
        // 匹配 filename*="utf-8''%E6%B5%8B%E8%AF%95.txt"
        re := regexp.MustCompile(`filename\*=(?:[^'']*')?([^'']*)''([^"]+)`)
        if m := re.FindStringSubmatchIndex([]byte(cd)); m != nil {
            enc := string(cd[m[0][1]:m[0][2]])
            name, _ := url.PathUnescape(enc) // ← 正确反解
            log.Printf("real filename: %s", name) // "测试.txt"
        }
    }
}