在 go 的 net/http 中，标准 responsewriter 接口不提供直接判断是否已写入响应的方法；需通过包装器（wrapper）记录写入状态，避免重复调用 writeheader 导致 "http: multiple response.writeheader calls" 错误。
在 go 的 net/http 中，标准 responsewriter 接口不提供直接判断是否已写入响应的方法；需通过包装器（wrapper）记录写入状态，避免重复调用 writeheader 导致 "http: multiple response.writeheader calls" 错误。
Go 的 http.ResponseWriter 是一个接口，其设计遵循“写即提交”语义：一旦调用 WriteHeader() 或 Write()（且未显式设置状态码时会隐式调用 WriteHeader(http.StatusOK)），HTTP 响应头即被发送至客户端，后续再调用 WriteHeader() 将触发运行时 panic —— 这正是你遇到的 http: multiple response.WriteHeader calls 错误根源。
遗憾的是，标准库并未暴露任何 Written() bool 或类似方法。你尝试通过 w.Header().Get("Status-Code") 判断是无效的，因为 Header() 返回的是可修改的 header 映射，它不反映实际是否已写入；Status-Code 也不是标准 header 字段（状态码不属于 header，而是响应起始行的一部分），因此该检查始终返回空字符串，无法作为依据。
✅ 正确解法：实现一个轻量级包装器，拦截并标记写入行为：
type doneWriter struct {
http.ResponseWriter
written bool // 标记是否已触发实际写入
}
func (dw *doneWriter) WriteHeader(statusCode int) {
dw.written = true
dw.ResponseWriter.WriteHeader(statusCode)
}
func (dw *doneWriter) Write(b []byte) (int, error) {
dw.written = true
return dw.ResponseWriter.Write(b)
}
// 可选：为兼容性补充 Flush（若底层支持）
func (dw *doneWriter) Flush() {
if f, ok := dw.ResponseWriter.(http.Flusher); ok {
f.Flush()
}
}
该包装器在每次 WriteHeader 或 Write 调用时将 written 置为 true，从而提供可靠的“是否已写入”信号。
? 典型使用场景：中间件中统一兜底响应
func ensureResponse(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
dw := &doneWriter{
ResponseWriter: w,
written: false,
}
next.ServeHTTP(dw, r)
// 若下游处理器未写入任何响应，则主动写入默认响应
if !dw.written {
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
w.WriteHeader(http.StatusOK)
fmt.Fprint(w, "OK")
}
})
}
⚠️ 注意事项：
- 不要试图在 handler 内部多次检查 dw.written 并条件写入——这仍可能导致竞态或逻辑混乱；应确保业务逻辑单点写入，包装器仅用于兜底或调试；
- doneWriter 不改变原有行为，完全透明兼容所有 http.ResponseWriter 扩展接口（如 http.Hijacker, http.Pusher），但需按需显式实现（如上例中的 Flush）；
- 生产环境推荐使用成熟封装，例如 github.com/flimzy/donewriter（作者开源的稳定实现），它已处理边界情况并提供 IsWritten() 方法。
总结：Go 的 HTTP 模型强调“责任明确”——谁写入，谁负责状态管理。没有银弹式的内置检测，但通过组合式 wrapper 模式，你既能保持代码清晰，又能安全规避重复写入错误。
