go network_error ai_generated true

error: http: superfluous response.WriteHeader call from ... (net/http: write tcp ...: write: broken pipe)

ID: go/http-server-timeout-write-broken-pipe

Also available as: JSON · Markdown · 中文
80%Fix Rate
85%Confidence
0Evidence
2024-03-15First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
1.20 active — — —
1.21 active — — —

Root Cause

HTTP处理程序在已经写入响应体后又调用了WriteHeader，且客户端提前断开连接，导致写入操作返回broken pipe错误。

generic

中文

HTTP处理程序在写入响应体后再次调用WriteHeader，同时客户端连接已断开，导致底层TCP写入返回管道断裂错误。

Workarounds

  1. 85% success 
    if w.Written() { return } // 使用自定义ResponseWriter跟踪写入状态，避免重复调用WriteHeader
  2. 90% success 
    在写入响应体前确保所有Header设置完成，并在WriteHeader后不再修改Header。

Dead Ends

Common approaches that don't work:

  1. 90% fail

    忽略错误不会解决根本问题，客户端已断开，继续写入只会浪费资源并可能引发更多错误。

  2. 70% fail

    net/http没有提供直接检查写入状态的方法，容易引入竞态条件。