17370845950

在 go 的 net/http 中，若在 handler 函数内启动新 goroutine 并调用 writeheader，会导致主线程与子 goroutine 竞态写入响应头，触发“multiple response.writeheader calls”错误。根本原因在于 http 服务器会在 handler 返回时自动补发状态码 200，而子 goroutine 又手动调用一次，造成重复。

HTTP 处理器（http.HandlerFunc）的执行模型是每个请求由独立 goroutine 承载，且 net/http 包对响应生命周期有严格约定：

• 若 Handler 函数返回前未调用 WriteHeader()，也未调用 Write()，则服务器会自动发送 200 OK 响应头；
• 若 Handler 已调用 WriteHeader() 或 Write()（后者隐式触发 WriteHeader(200)），则服务器不再干预；
• 但一旦响应头已写出，再次调用 WriteHeader() 就会 panic 并记录 http: multiple response.WriteHeader calls 错误。

在你的代码中，匿名 Handler 函数如下：

func(w http.ResponseWriter, r *http.Request) {
    fmt.Println(r.URL)
    go HandleIndex(w, r) // ⚠️ 启动并发 goroutine，但自身立即返回
}

该函数打印 URL 后立刻启动 HandleIndex 并不等待，随即结束。此时 net/http 认为 Handler 已完成处理，自动写入 200 OK 响应头；与此同时，HandleIndex 在另一 goroutine 中执行 w.WriteHeader(200) —— 两次写入冲突，错误必然发生。

更严重的是：http.ResponseWriter 不是线程安全的，跨 goroutine 使用同一 ResponseWriter 实例不仅会触发 header 冲突，还可能导致响应体写入混乱、数据截断甚至 panic。

✅ 正确做法是：所有响应操作（包括 WriteHeader 和 Write）必须在同一个 Handler goroutine 中完成。如需异步逻辑（例如日志上报、消息队列投递、耗时计算），应确保它们不干扰响应流：

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Println("Handling:", r.URL.Path)

        // ✅ 同步写入响应（必须在当前 goroutine）
        w.WriteHeader(200)
        _, _ = w.Write([]byte("Hello, World!"))

        // ✅ 异步任务：启动 goroutine，但绝不操作 w！
        go func() {
            // 例如：记录访问日志到文件/数据库、发送监控指标等
            log.Printf("Async handled: %s from %s", r.URL.Path, r.RemoteAddr)
        }()
    })

    log.Println("Starting Server on :5678...")
    log.Fatal(http.ListenAndServe(":5678", nil))
}

⚠️ 注意事项：

• 不要将 ResponseWriter 传递给其他 goroutine；
• 不要在 Handler 中 go handle(w, r) —— 这是典型反模式；
• 如需真正异步响应（如长轮询、SSE、WebSocket），应使用专用库（如 gorilla/websocket）或显式管理连接生命周期；
• Chrome 自动请求 /favicon.ico 是另一个常见诱因（你日志中出现两次输出即源于此），可通过添加 favicon 路由或忽略该路径规避干扰测试。

总结：Go 的 net/http 设计强调「Handler 即响应单元」——它必须原子性地完成响应构建。把 WriteHeader 和 Write 放进 goroutine，本质上破坏了这一契约。坚守同步响应 + 异步副作用的分工原则，即可彻底避免此类错误。