连接管理
处理断开连接
连接管理 是 CoddyKit 上的免费 Go Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
连接不会永久持续
客户端可能会关闭标签页、失去 Wi-Fi 连接或崩溃。健壮的 WebSocket 服务器必须检测断开连接、清理资源并释放协程。否则就会泄漏内存和套接字。
关闭握手
干净地关闭连接时,双方都会发送关闭帧。gorilla 会将其作为 ReadMessage 返回的错误提供给您,您可以检查其中的关闭代码。
if websocket.IsCloseError(err, websocket.CloseNormalClosure) {
// graceful close
}Ping/Pong 保活
为了检测半开连接(对端消失但没有关闭连接),服务器会定期发送 ping 控制帧,并等待 pong 回复。
conn.SetPongHandler(func(string) error {
conn.SetReadDeadline(time.Now().Add(60 * time.Second))
return nil
})读取截止时间
设置读取截止时间,使失效的对端最终返回错误,而不是永久阻塞。每当收到 pong 时都要刷新截止时间。
conn.SetReadDeadline(time.Now().Add(60 * time.Second))Ping 定时器
写入协程中的定时器会定期触发 ping。如果写入失败,说明连接已经失效,您应退出协程。
ticker := time.NewTicker(54 * time.Second)
defer ticker.Stop()
for range ticker.C {
if err := conn.WriteMessage(websocket.PingMessage, nil); err != nil {
return
}
}退出时清理
读取循环或写入循环结束时,请注销客户端并关闭连接。defer 可以确保即使发生 panic 也能完成这些操作。
defer func() {
hub.unregister <- client
conn.Close()
}()每个连接使用两个协程
标准模式是为每个连接运行一个 readPump 和一个 writePump。当其中一个检测到错误时,它会触发清理操作,使另一个停止(通常通过关闭 send 通道实现)。
同样设置写入截止时间
设置写入截止时间,使卡住的写入不会让协程永久挂起。写入超时会返回错误,您应拆除该连接。
conn.SetWriteDeadline(time.Now().Add(10 * time.Second))优雅地关闭服务器
关闭服务器时,向每个客户端发送关闭帧,然后短暂等待。将此操作与 http.Server.Shutdown 和上下文截止时间结合使用。
conn.WriteMessage(websocket.CloseMessage,
websocket.FormatCloseMessage(websocket.CloseGoingAway, "bye"))客户端重新连接
断开连接是正常情况。客户端应实现指数退避重连逻辑。服务器端只需干净地处理每次连接和断开。
可运行示例:超时检测类比
WebSocket 保活需要使用库;这个标准库程序通过定时器和通道,模拟基于截止时间的存活检查。
package main
import (
"fmt"
"time"
)
func main() {
pong := make(chan struct{})
go func() {
time.Sleep(20 * time.Millisecond) // simulate a slow/absent peer
_ = pong // no pong sent -> dead connection
}()
select {
case <-pong:
fmt.Println("alive")
case <-time.After(10 * time.Millisecond):
fmt.Println("no pong: closing dead connection")
}
}快速检查
请测试您对连接管理的理解。
回顾
您学习了连接管理:
- 处理关闭握手并检查关闭代码
- 结合使用 ping/pong 和读写截止时间来检测失效的对端
- 运行读取和写入泵;使用
defer清理资源 - 通过关闭帧优雅地关闭连接;客户端使用退避策略重新连接
常见问题解答
「连接管理」课时是免费的吗?
是的 — 「连接管理」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Go Academy 课程的其余内容,请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「连接管理」这节课中我会学到什么?
处理断开连接 你通过在浏览器中直接运行的动手代码来练习 Go Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「连接管理」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗?
能。每节 Go Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。