Echo框架不内置WebSocket支持，需手动接管http.ResponseWriter和*http.Request，用net/http.Upgrade配合gorilla/websocket等库实现升级与连接管理。
Echo 框架本身**不内置 WebSocket 支持**——它是一个 HTTP 路由器，不是 WebSocket 服务器。你不能直接用 echo.GET("/ws", ...) 处理 WebSocket 升级请求，因为 Echo 默认不解析 Upgrade: websocket 头、不处理握手、也不管理连接生命周期。
要实现实时通信，必须手动接管底层 http.ResponseWriter 和 *http.Request，调用标准库的 net/http.Upgrade，再用第三方库（如 gorilla/websocket）接管连接。这是最常见也最容易出错的起点。
为什么 echo.Use() 或 echo.GET() 无法直接处理 WebSocket
Echo 的中间件和路由逻辑只在 HTTP 请求完成前运行；一旦调用 http.ResponseWriter.WriteHeader() 或写入响应体，就无法再执行 WebSocket 升级。而升级必须在响应头写入前，通过 http.Hijacker 获取底层 TCP 连接。
-
Echo默认禁用Hijack，且其Context.Response()是封装过的，不暴露原始http.ResponseWriter - 即使你强行用
c.Response().Writer，它可能已被包装（如 gzip middleware），导致Hijack()失败并报"hijack not supported" - 所有
Echo中间件（日志、CORS、JWT 验证等）若在 WebSocket 路由前执行，可能提前写响应或关闭连接
正确接入 WebSocket 的三步落地法
必须绕过 Echo 的 HTTP 生命周期，用原生 net/http 注册一个独立 handler，并确保它在 Echo 的 Server.Handler 之前被注册（或使用 echo.Server().SetHandler() 替换整个 handler）。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 定义裸 handler：
func(w http.ResponseWriter, r *http.Request) { ... }，里面调用upgrader.Upgrade(w, r, nil) - 禁用所有影响
Hijack的中间件：移除echo.MiddlewareFunc中对 WebSocket 路径的拦截，尤其避免echo.WrapMiddleware封装该路径 - 注册到
Echo的底层http.ServeMux或直接替换Server.Handler：e.Server.Handler = http.NewServeMux()，再Handle("/ws", wsHandler)
示例关键片段：
upgrader := websocket.Upgrader{
CheckOrigin: func(r *http.Request) bool { return true },
}
wsHandler := func(w http.ResponseWriter, r *http.Request) {
conn, err := upgrader.Upgrade(w, r, nil)
if err != nil {
return
}
defer conn.Close()
for {
_, msg, err := conn.ReadMessage()
if err != nil {
break
}
conn.WriteMessage(websocket.TextMessage, msg)
}
}
// ⚠️ 不要用 e.GET("/ws", ...)，而是：
e.Server.Handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path == "/ws" && r.Header.Get("Upgrade") == "websocket" {
wsHandler(w, r)
return
}
e.Server.Handler.ServeHTTP(w, r) // fallback to Echo
})
消息广播与连接管理必须自己实现
Echo 不提供连接池、广播通道或心跳管理。每个 *websocket.Conn 是独立对象，你要自行维护 map[string]*websocket.Conn 或用 sync.Map 存储活跃连接，并注意并发安全。
- 不要在
ReadMessage循环里直接WriteMessage—— 可能 panic：connection closed - 必须监听
conn.CloseRead()或conn.SetReadDeadline()配合err.(*websocket.CloseError)判断断连 - 广播时需加锁遍历连接表，且每个
WriteMessage应设超时（用conn.SetWriteDeadline()），否则一个慢连接会阻塞全部 - 别依赖
defer conn.Close()—— 它只在函数退出时触发，而 WebSocket handler 是长运行的，应显式在循环 break 后 close
Echo 一概不管。 
