Golang中HTTP响应JSON编码出错时如何覆盖响应状态码？

首先得明确一个核心限制：HTTP响应头一旦通过w.WriteHeader()发送给客户端，就无法再修改状态码了。你原代码里先调用了w.WriteHeader(code)（设置201），之后才做JSON编码，这时候如果编码出错，已经没法把状态码改成5xx了——客户端早就收到201的状态了。

所以正确的思路是：先确保JSON编码能成功，再发送响应头和状态码。如果编码失败，直接返回500类的错误状态。

具体实现方案 #

这里提供两种可靠的写法，都能解决你的问题：

方案1：先序列化再发送（推荐）

先把要返回的数据序列化成JSON字节，提前捕获错误。只有序列化成功后，才设置响应头和状态码：

type success struct {
    Data interface{} `json:"data"`
}

func writeResp(w http.ResponseWriter, code int, data interface{}) {
    // 1. 先尝试序列化响应数据，提前捕获错误
    resp := success{Data: data}
    jsonBytes, err := json.Marshal(resp)
    if err != nil {
        // 序列化失败，返回500内部服务器错误
        w.Header().Set("Content-Type", "application/json")
        w.WriteHeader(http.StatusInternalServerError)
        // 返回结构化的错误响应
        errorResp := map[string]string{"error": "failed to process response data"}
        // 这里即使编码错误响应失败，也不用太纠结——毕竟主逻辑已经失败了
        _ = json.NewEncoder(w).Encode(errorResp)
        return
    }

    // 2. 序列化成功，正常发送响应
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(code)
    _, _ = w.Write(jsonBytes)
}

方案2：直接用Encoder但提前检查（适合大数据场景）

如果你的响应数据很大，提前Marshal会占用过多内存，可以用json.NewEncoder直接写入，但需要注意：Encode方法会在写入时才返回错误，而如果此时已经发送了响应头，就没法改状态码了。这种情况下可以先不手动调用WriteHeader，让Go自动在第一次写入时发送状态码，若编码失败再尝试修改：

func writeResp(w http.ResponseWriter, code int, data interface{}) {
    w.Header().Set("Content-Type", "application/json")
    // 先不手动调用WriteHeader，让Go在第一次Write时自动发送状态码
    resp := success{Data: data}
    err := json.NewEncoder(w).Encode(resp)
    if err != nil {
        // 尝试设置500状态码，如果返回nil说明响应头还没发送
        if err := w.WriteHeader(http.StatusInternalServerError); err == nil {
            _ = json.NewEncoder(w).Encode(map[string]string{"error": "failed to write response"})
        }
        // 如果已经发送过状态码，只能接受客户端收到了之前的状态
        return
    }
}

避坑提醒 #

• 不要用panic：虽然Go的HTTP服务器会自动recovery panic并返回500，但这属于异常流程，会导致goroutine终止，还可能泄露栈信息，不是优雅的错误处理方式。
• http.Error()是可行的，但它默认返回的Content-Type是text/plain，如果你的客户端期望JSON格式，最好自己构造JSON错误响应。

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