Go HTTP服务器不支持连接状态回调，Gin作为封装亦无此功能；仅能通过Hijacker接管长连接或Context.Done()感知请求级中断，ConnState已被弃用且不可靠。
Go HTTP 服务器本身不支持连接状态回调
Gin 是基于 Go net/http 的封装，而标准库的 http.Server 并没有暴露客户端连接建立、断开或超时的事件钩子。你无法像 Node.js 的 req.on('close') 或 Java Servlet 的 HttpSessionListener 那样直接监听连接生命周期。
所谓“监听连接状态变化”，实际能做的只有两种路径：一是利用底层 http.Hijacker 手动接管连接（适用于长连接场景，如 WebSocket 或自定义协议）；二是通过中间件 + 上下文 + 超时控制间接感知请求级生命周期 —— 但注意，这和 TCP 连接不是一回事。
用 Hijack 捕获连接建立与关闭（仅限长连接）
如果你在做 WebSocket、SSE 或自定义 TCP 流式响应，可以调用 ResponseWriter.Hijack() 获取底层 net.Conn，然后启动 goroutine 监听其关闭信号。
-
Hijack()必须在写入响应头后、写入 body 前调用，否则会 panic - 调用后不能再使用
c.Writer，否则触发http: connection closed before response completed - 必须手动管理连接读写和超时，Gin 中间件（如
gin.Recovery()）对 hijacked 连接无效
// 示例：简单回显服务，监听连接关闭
func handleHijack(c *gin.Context) {
conn, _, err := c.Writer.Hijack()
if err != nil {
c.AbortWithStatus(http.StatusInternalServerError)
return
}
defer conn.Close()
<pre class="brush:php;toolbar:false;">// 启动 goroutine 监听连接关闭
done := make(chan struct{})
go func() {
_, _ = io.Copy(ioutil.Discard, conn) // 等待对方关闭
close(done)
}()
select {
case <-done:
log.Println("client disconnected")
case <-time.After(30 * time.Second):
log.Println("timeout, closing")
}}
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
HTTP 请求级“连接状态”只能靠上下文取消和超时模拟
对于普通 HTTP 请求（短连接），客户端断开时，net.Conn.Read() 会返回 io.EOF 或 net.ErrClosed，但 http.Server 默认不会主动通知 handler。Gin 提供的 c.Request.Context().Done() 是唯一可靠入口 —— 它在客户端中断、超时或服务端主动 cancel 时触发。
- 必须在 handler 内部持续检查
c.Request.Context().Done()，尤其在阻塞 I/O（如数据库查询、RPC 调用）前后 - 不能依赖
defer函数捕获断开：goroutine 可能已退出，defer不一定执行 - 设置
http.Server.ReadTimeout/WriteTimeout会影响Context().Done()触发时机，需与业务超时对齐
func handleWithContext(c *gin.Context) {
ctx := c.Request.Context()
done := ctx.Done()
<pre class="brush:php;toolbar:false;">// 模拟耗时操作
ch := make(chan string, 1)
go func() {
time.Sleep(5 * time.Second)
ch <- "result"
}()
select {
case res := <-ch:
c.String(http.StatusOK, res)
case <-done:
log.Printf("request canceled: %v", ctx.Err())
return // 客户端已断开，不写响应
}}
立即学习“go语言免费学习笔记（深入）”；
别把 net.Conn.Close() 当成连接状态变更事件源
有人试图在 http.Server.ConnState 回调里做日志或统计，但这只是连接状态机的内部快照（StateNew, StateActive, StateClosed 等），且该字段在 Go 1.21+ 已被标记为 deprecated，官方明确不建议依赖它做业务逻辑。
-
ConnState不保证顺序，多个 goroutine 并发调用时可能看到乱序状态 - 它反映的是底层 TCP 连接状态，而非 HTTP 请求是否完成 —— 一个连接可承载多个请求（HTTP/1.1 keep-alive），
StateClosed可能发生在最后一个请求结束后很久 - Gin 未提供任何封装接口访问此字段，需在启动
http.Server时手动设置，且无法与 Gin 的路由、中间件上下文联动
真要统计活跃连接数，更稳妥的方式是：用 sync.Map + http.Server.RegisterOnShutdown + Hijack 组合，只对明确需要长连接的 endpoint 生效。其余场景，老老实实靠 Context 和可观测性指标（如 Prometheus 的 http_request_duration_seconds）来推断异常中断。
