怎样用Golang实现WebSocket 实时通信服务开发-Golang-PHP中文网

怎样用Golang实现WebSocket 实时通信服务开发

P粉602998670

发布： 2025-08-19 12:05:01

原创

735人浏览过

使用Go和gorilla/websocket库可实现高性能WebSocket服务，1. 通过Upgrade将HTTP升级为WebSocket连接；2. 使用Hub结构管理客户端连接池，实现消息广播；3. 前端通过WebSocket API发送和接收消息，多个浏览器窗口可实现实时群聊功能。

怎样用golang实现websocket 实时通信服务开发

WebSocket 是一种在单个 TCP 连接上进行全双工通信的协议，非常适合实现实时通信功能，比如聊天室、通知推送、在线协作等。Golang 凭借其高并发和轻量级 goroutine 的特性，非常适合开发高性能的 WebSocket 服务。下面介绍如何使用 Go 和第三方库 gorilla/websocket 实现一个简单的 WebSocket 实时通信服务。

1. 安装依赖库

Go 标准库没有内置 WebSocket 支持，我们使用广泛使用的 gorilla/websocket 库：

go get github.com/gorilla/websocket

2. 建立 WebSocket 连接

首先创建一个 HTTP 服务，并升级普通 HTTP 请求为 WebSocket 连接。

示例代码：

立即学习“go语言免费学习笔记（深入）”；

package main

import ( "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. 实现客户端广播（群聊）

在实际场景中，通常需要将消息广播给多个客户端。为此，可以维护一个客户端连接池。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

定义一个中心化的 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 页面测试连接：

<!DOCTYPE html> <html> <body> <input id="input" type="text" /> <button onclick="send()">发送</button> <ul id="messages"></ul> <script> const ws = new WebSocket("ws://localhost:8080/ws"); ws.onmessage = function(event) { const messages = document.getElementById('messages'); const li = document.createElement('li'); li.textContent = event.data; messages.appendChild(li); };

function send() { const input = document.getElementById('input'); ws.send(input.value); input.value = ''; } </script> </body> </html>

打开多个浏览器窗口，输入消息即可实现群聊。

基本上就这些。通过 gorilla/websocket 和一个 Hub 结构，就能实现一个基础但完整的 WebSocket 实时通信服务。后续可扩展身份认证、私聊、消息持久化等功能。不复杂但容易忽略的是连接管理和错误处理，务必在生产环境中加入日志、超时控制和并发安全机制。

以上就是怎样用Golang实现WebSocket 实时通信服务开发的详细内容，更多请关注php中文网其它相关文章！