Golang如何实现WebSocket通信_Golang WebSocket通信实践详解

轻宇大大_4067

轻宇大大_4067

2025-10-31

594人浏览

原创

首先使用 gorilla/websocket 库实现 WebSocket 服务,定义 Upgrader 并处理连接请求,在 wsHandler 中读取和回显消息,最后通过 http.ListenAndServe 启动服务,并用 JavaScript 或 Go 客户端测试通信。

golang如何实现websocket通信_golang websocket通信实践详解

WebSocket 是一种在单个 TCP 连接上进行全双工通信的协议,相比传统的 HTTP 轮询,它能显著降低延迟并提升实时性。Golang 凭借其高并发和轻量级 Goroutine 的优势,非常适合构建高性能的 WebSocket 服务。本文将详细介绍如何使用 Go 实现 WebSocket 通信,并提供完整可运行的实践示例。

使用 gorilla/websocket 库实现 WebSocket 服务

Go 标准库不直接支持 WebSocket,但社区广泛使用的 gorilla/websocket 库提供了完整的实现。首先安装该库:

go get github.com/gorilla/websocket

接下来创建一个基础的 WebSocket 服务器:

定义升级器(Upgrader),用于将 HTTP 连接升级为 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.Println("Upgrade error:", err)
        return
    }
    defer conn.Close()

    for {
        _, msg, err := conn.ReadMessage()
        if err != nil {
            log.Println("Read error:", err)
            break
        }
        log.Printf("Received: %s", msg)

        err = conn.WriteMessage(websocket.TextMessage, msg)
        if err != nil {
            log.Println("Write error:", err)
            break
        }
    }
}

启动 HTTP 服务:

func main() {
    http.HandleFunc("/ws", wsHandler)
    log.Println("Server started on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

客户端连接与消息收发

使用 JavaScript 浏览器客户端测试服务:

<script><br>const ws = new WebSocket("ws://localhost:8080/ws");<br>ws.onopen = () => {<br>&nbsp;&nbsp;ws.send("Hello, Go WebSocket!");<br>};<br>ws.onmessage = (event) => {<br>&nbsp;&nbsp;console.log("Received:", event.data);<br>};<br></script>

你也可以用 Go 编写客户端:

git-push
git-push

自动用 git 提交代码并推送到远程仓库。当用户输入 `/gitpush` 时触发此技能。功能包括:自动暂存所有更改、自动生成提交信息、自动提交到本地仓库、自动推送到远程分支。成功后报告提交状态、文件数量和耗时。

下载
func main() {
    conn, _, err := websocket.DefaultDialer.Dial("ws://localhost:8080/ws", nil)
    if err != nil {
        log.Fatal(err)
    }
    defer conn.Close()

    conn.WriteMessage(websocket.TextMessage, []byte("Hi from Go client"))
    _, msg, _ := conn.ReadMessage()
    fmt.Printf("Response: %s\n", msg)
}

实现广播机制与连接管理

实际项目中通常需要管理多个连接并支持广播。可以使用 map 和互斥锁来保存客户端连接:

var clients = make(map[*websocket.Conn]bool)
var broadcast = make(chan []byte)
var mutex = sync.Mutex{}

在处理函数中注册连接:

mutex.Lock()
clients[conn] = true
mutex.Unlock()

启动广播监听协程:

go func() {
    for {
        msg :=         mutex.Lock()
        for client := range clients {
            err := client.WriteMessage(websocket.TextMessage, msg)
            if err != nil {
                client.Close()
                delete(clients, client)
            }
        }
        mutex.Unlock()
    }
}()

收到消息后推送到广播通道:

broadcast

心跳检测与连接健康维护

长时间空闲可能导致连接中断。通过 Ping/Pong 机制维持活跃:

conn.SetReadDeadline(time.Now().Add(60 * time.Second))
conn.SetPongHandler(func(string) error {
    conn.SetReadDeadline(time.Now().Add(60 * time.Second))
    return nil
})

服务端定期发送 Ping 消息:

go func() {
    ticker := time.NewTicker(54 * time.Second)
    defer ticker.Stop()
    for {
        select {
        case             if err := conn.WriteMessage(websocket.PingMessage, nil); err != nil {
                return
            }
        }
    }
}()

基本上就这些。通过 gorilla/websocket,Go 能轻松实现稳定高效的 WebSocket 服务。关键在于连接管理、并发安全和心跳机制的设计。实际部署时建议结合 TLS 使用 wss 协议保障安全。不复杂但容易忽略细节,比如关闭连接和资源清理。

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

539

5

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

616

5

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

1316

5

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.05

811

5

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.05.21

1946

6

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

5574

18

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2025.06.10

2594

13

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

2025.06.17

4426

17

golang数组大全
golang数组大全

本专题整合了golang数组相关问题解决方法,想了解更多相关内容,请阅读下面的文章。

2025.06.20

5846

22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.9万人学习