Golang实现WebSocket实时通信教程
使用Go和gorilla/websocket库可实现高性能WebSocket服务，1.通过Upgrade将HTTP升级为WebSocket连接；2.使用Hub结构管理客户端连接池，实现消息广播；3.前端通过WebSocketAPI发送和接收消息，多个浏览器窗口可实现实时群聊功能。
使用Go和gorilla/websocket库可实现高性能WebSocket服务，1. 通过Upgrade将HTTP升级为WebSocket连接；2. 使用Hub结构管理客户端连接池，实现消息广播；3. 前端通过WebSocket API发送和接收消息，多个浏览器窗口可实现实时群聊功能。
WebSocket 是一种在单个 TCP 连接上进行全双工通信的协议，非常适合实现实时通信功能，比如聊天室、通知推送、在线协作等。Golang 凭借其高并发和轻量级 goroutine 的特性，非常适合开发高性能的 WebSocket 服务。下面介绍如何使用 Go 和第三方库 gorilla/websocket 实现一个简单的 WebSocket 实时通信服务。
1. 安装依赖库
Go 标准库没有内置 WebSocket 支持，我们使用广泛使用的 gorilla/websocket 库：
go get github.com/gorilla/websocket2. 建立 WebSocket 连接
首先创建一个 HTTP 服务，并升级普通 HTTP 请求为 WebSocket 连接。
示例代码：
package mainimport ( "log" "net/http" "github.com/gorilla/websocket" )
var upgrader = websocket.Upgrader{ CheckOrigin: func(r *http.Request) bool { return true // 允许跨域 }, }
func wsHandler(w http.ResponseWriter, r *http.Request) { conn, err := upgrader.Upgrade(w, r, nil) if err != nil { log.Print("Upgrade error:", err) return } defer conn.Close()
// 连接建立成功，可以开始收发消息
for {
messageType, message, err := conn.ReadMessage()
if err != nil {
log.Print("Read error:", err)
break
}
log.Printf("Received: %s", message)
// 回显消息
if err := conn.WriteMessage(messageType, message); err != nil {
log.Print("Write error:", err)
break
}
}}
func main() { http.HandleFunc("/ws", wsHandler) log.Println("Server starting on :8080") log.Fatal(http.ListenAndServe(":8080", nil)) }
3. 实现客户端广播（群聊）
在实际场景中，通常需要将消息广播给多个客户端。为此，可以维护一个客户端连接池。
定义一个中心化的 Hub 来管理所有连接：
type Hub struct { clients map[*websocket.Conn]bool broadcast chan []byte register chan *websocket.Conn unregister chan *websocket.Conn }func newHub() Hub { return &Hub{ clients: make(map[websocket.Conn]bool), broadcast: make(chan []byte), register: make(chan websocket.Conn), unregister: make(chan websocket.Conn), } }
func (h *Hub) run() { for { select { case conn := <-h.register: h.clients[conn] = true case conn := <-h.unregister: if _, ok := h.clients[conn]; ok { delete(h.clients, conn) conn.Close() } case message := <-h.broadcast: for conn := range h.clients { if err := conn.WriteMessage(websocket.TextMessage, message); err != nil { log.Print("Broadcast error:", err) conn.Close() delete(h.clients, conn) } } } } }
修改处理函数，接入 Hub：
func wsHandler(hub *Hub) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { conn, err := upgrader.Upgrade(w, r, nil) if err != nil { log.Print("Upgrade error:", err) return } defer conn.Close() hub.register <- conn
// 读取消息
for {
_, message, err := conn.ReadMessage()
if err != nil {
hub.unregister <- conn
break
}
// 广播给所有客户端
hub.broadcast <- message
}
}}
在 main 函数中启动 Hub：
func main() { hub := newHub() go hub.run()http.HandleFunc("/ws", wsHandler(hub))
log.Println("Server on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))}
4. 简单的前端测试页面
创建一个 HTML 页面测试连接：
打开多个浏览器窗口，输入消息即可实现群聊。
基本上就这些。通过 gorilla/websocket 和一个 Hub 结构，就能实现一个基础但完整的 WebSocket 实时通信服务。后续可扩展身份认证、私聊、消息持久化等功能。不复杂但容易忽略的是连接管理和错误处理，务必在生产环境中加入日志、超时控制和并发安全机制。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台，提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具，适合短剧、漫剧、广告及社交媒体内容制作。
Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，