讲师中心 微信公众号
AI工具推荐 视频效率加速

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

大枫姑娘_5697

大枫姑娘_5697

发布时间:2025-08-19 12:05:01

|

759人浏览过

|

来源于php中文网

原创

使用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. 实现客户端广播(群聊)

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

git-version-control
git-version-control

基于 Git 的 OpenClaw 系统配置变更版本控制。提供两项核心能力:(1)SAVE —— 在执行敏感操作前创建检查点……

下载

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

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

519

2024.02.23

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

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

596

2024.02.23

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

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

1156

2024.02.23

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

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

771

2024.03.05

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

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

1686

2024.05.21

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

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

4774

2025.06.09

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

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

2194

2025.06.10

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

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

4086

2025.06.17

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8.1万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn