Go编写REST API：文件上传接口返回空响应问题求助

我之前开发Go的文件上传接口时也踩过类似的坑，结合你的描述，大概率是处理multipart表单时的几个常见问题导致的，咱们一步步排查解决：

1. 表单解析失败或未执行 #

处理文件上传的核心第一步是调用r.ParseMultipartForm(maxMemory)解析请求中的multipart表单数据，如果这一步出错（比如内存上限设置太小、请求格式不符合要求），或者你直接跳过这一步就返回响应，很容易导致响应异常甚至空返回。

一定要先确保表单解析成功，再处理文件逻辑，示例代码如下：

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    // 设置内存上限，比如10MB，超过的部分会临时存到磁盘
    err := r.ParseMultipartForm(10 << 20)
    if err != nil {
        resp := apiResponse{Status: http.StatusBadRequest, Message: "表单解析失败: " + err.Error()}
        // 先设置响应头
        w.Header().Set("Content-Type", "application/json")
        // 再设置状态码
        w.WriteHeader(resp.Status)
        // 最后序列化响应体
        json.NewEncoder(w).Encode(resp)
        return
    }

    // 获取上传的文件
    file, handler, err := r.FormFile("file")
    if err != nil {
        resp := apiResponse{Status: http.StatusBadRequest, Message: "获取文件失败: " + err.Error()}
        w.Header().Set("Content-Type", "application/json")
        w.WriteHeader(resp.Status)
        json.NewEncoder(w).Encode(resp)
        return
    }
    defer file.Close()

    // 这里写你的文件处理逻辑（比如保存到磁盘）
    // ...

    // 返回成功响应
    resp := apiResponse{Status: http.StatusOK, Message: "文件上传成功"}
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(resp.Status)
    json.NewEncoder(w).Encode(resp)
}

2. 响应头与状态码顺序错误 #

Go的HTTP响应有严格的顺序要求：必须先设置响应头，再调用w.WriteHeader()，最后写入响应体。如果顺序搞反（比如先写响应体再设置状态码），Go会自动发送默认的200状态码，后续的状态码设置会失效，甚至导致响应内容被截断，出现你说的“Empty response”问题。

❌ 错误示例：

// 先写响应体，再设置状态码，会导致异常
json.NewEncoder(w).Encode(resp)
w.WriteHeader(resp.Status)

✅ 正确顺序：

w.Header().Set("Content-Type", "application/json")
w.WriteHeader(resp.Status)
json.NewEncoder(w).Encode(resp)

3. 未捕获文件处理过程中的错误 #

在文件读写、保存的整个流程中，任何一步出错都要及时返回错误响应，不能让函数默默退出。比如创建文件失败、写入磁盘出错时，如果直接return而不写响应，客户端就会收到空响应。

举个保存文件的错误处理示例：

// 尝试创建目标文件
dst, err := os.Create("./uploads/" + handler.Filename)
if err != nil {
    resp := apiResponse{Status: http.StatusInternalServerError, Message: "创建文件失败: " + err.Error()}
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(resp.Status)
    json.NewEncoder(w).Encode(resp)
    return
}
defer dst.Close()

// 复制文件内容到目标文件
if _, err := io.Copy(dst, file); err != nil {
    resp := apiResponse{Status: http.StatusInternalServerError, Message: "保存文件失败: " + err.Error()}
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(resp.Status)
    json.NewEncoder(w).Encode(resp)
    return
}

4. 内存上限设置过小 #

如果用户上传的文件超过了ParseMultipartForm设置的内存上限，且服务器磁盘临时目录不可写，也会导致解析失败，进而返回异常响应。可以适当调大内存上限，或者检查服务器临时目录的权限。

按照上面的步骤排查，应该就能解决你的文件上传接口空响应问题啦！

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