首页 > Golang > Go教程

Golang实现WebSocket实时通信详解

时间：2025-08-25 15:00:35 166浏览收藏

想要实现实时通信？这篇**Golang WebSocket教程**将手把手教你如何使用Go语言和`gorilla/websocket`库构建高性能的WebSocket服务！文章详细讲解了如何通过`Upgrade`方法将HTTP连接升级为WebSocket连接，并利用Hub结构管理客户端连接池，轻松实现消息广播，打造实时群聊功能。无需复杂配置，即可快速搭建一个支持多浏览器窗口实时通信的WebSocket服务。还在等什么？快来学习**Golang WebSocket**技术，开启你的实时通信之旅吧！

使用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 连接。

示例代码：

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

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

定义一个中心化的 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 实时通信服务。后续可扩展身份认证、私聊、消息持久化等功能。不复杂但容易忽略的是连接管理和错误处理，务必在生产环境中加入日志、超时控制和并发安全机制。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。