Golang利用WebSocket实现实时推送功能

 更新时间:2026年03月15日 09:05:14   作者:我叫黑大帅  
WebSocket 是一个实时双向通信的协议,底层用 TCP,借用 HTTP 建立连接,专门用来做实时功能,下面小编就和大家详细介绍一下Golang如何利用WebSocket实现实时推送功能吧

HTTP的问题是 一问一答,短连接

  • 客户端主动发请求 → 服务端才返回数据
  • 服务端不能主动给客户端发消息
  • 每次通信都要重新建立连接(像发短信

WebSocket 就是为了解决这个问题诞生的,基于 TCP 的 双向长连接 通信协议

  • 一次连接,永久保持(直到断开)
  • 客户端 ↔ 服务端 随时互相发消息
  • 服务端可以主动推送消息给客户端
  • 打电话:接通后,你随时说,对方随时说

WebSocket 是一个「实时双向通信」的协议,底层用 TCP,借用 HTTP 建立连接,专门用来做实时功能。

WebSocket 能干嘛

  • 服务端主动推消息(HTTP 做不到!)
  • 双向实时通信(毫秒级延迟)
  • 长连接,不用反复创建连接
  • 轻量,开销比 HTTP 小很多
  • 浏览器原生支持(网页直接用)
  • 实时推送、聊天、直播

极简示例

package main

import (
	"fmt"
	"net/http"

	"github.com/gorilla/websocket" // go get github.com/gorilla/websocket
)

// 定义 WebSocket 升级器:把 HTTP 连接升级成 WebSocket
var upgrader = websocket.Upgrader{
	// 允许跨域(测试用)
	CheckOrigin: func(r *http.Request) bool {
		return true
	},
}

// 处理 WebSocket 连接
func wsHandler(w http.ResponseWriter, r *http.Request) {
	// 1. 把 HTTP 连接升级为 WebSocket 连接
	conn, err := upgrader.Upgrade(w, r, nil)
	if err != nil {
		fmt.Println("升级失败:", err)
		return
	}
	defer conn.Close()

	fmt.Println("客户端已连接!")

	// 2. 循环接收/发送消息(长连接)
	for {
		// 读取客户端消息
		msgType, msg, err := conn.ReadMessage()
		if err != nil {
			fmt.Println("客户端断开连接")
			break
		}

		fmt.Printf("收到消息:%s\n", string(msg))

		// 服务端主动回消息
		reply := "服务端收到:" + string(msg)
		conn.WriteMessage(msgType, []byte(reply))
	}
}

func main() {
	http.HandleFunc("/ws", wsHandler)
	fmt.Println("WebSocket 服务启动:ws://127.0.0.1:8081/ws")
	http.ListenAndServe(":8081", nil)
	// 测试: wscat -c ws://127.0.0.1:8081/ws
}

核心 API

websocket.Upgrader把 HTTP 连接 → 升级成 WebSocket 长连接(WebSocket 必须先用 HTTP 握手)

var upgrader = websocket.Upgrader{
	CheckOrigin: func(r *http.Request) bool {
		return true // 允许跨域(开发必开)
	},
}

upgrader.Upgrade()执行升级,得到 WebSocket 连接对象*websocket.Conn

conn, err := upgrader.Upgrade(w, r, nil)

conn.ReadMessage()阻塞读取客户端发来的消息返回:消息类型、消息内容、错误

msgType, msg, err := conn.ReadMessage()

conn.WriteMessage()服务端主动发消息给客户端(核心能力!)

conn.WriteMessage(msgType, []byte("你好客户端"))

conn.ReadJSON()/conn.WriteJSON()直接收发 JSON 结构体(不用手动序列化)

// 接收 JSON
var data map[string]any
conn.ReadJSON(&data)

// 发送 JSON
conn.WriteJSON(map[string]any{
    "code": 200,
    "msg":  "服务端推送",
})

到此这篇关于Golang利用WebSocket实现实时推送功能的文章就介绍到这了,更多相关Golang WebSocket实时推送内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Golang分布式应用之Redis示例详解

    Golang分布式应用之Redis示例详解

    这篇文章主要为大家介绍了Golang分布式应用之Redis示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-07-07
  • Windows中Golang编译运行缓慢的解决方法

    Windows中Golang编译运行缓慢的解决方法

    Go语言编译运行缓慢问题可能是由于Windows 11更新引入的PCManagerServiceStore进程导致的,该进程会强制检查Go代码编译过程,消耗大量系统资源,下面就来介绍一下该问题的解决
    2025-08-08
  • Golang 中 return 与 defer关键字实践指南

    Golang 中 return 与 defer关键字实践指南

    本文详细介绍了Go语言中return和defer的关键特性,包括它们的执行顺序、在不同场景下的行为,以及defer的其他重要特性,通过具体代码示例,文章帮助读者理解如何正确使用defer,避免常见的陷阱,从而编写出更健壮和易维护的代码,感兴趣的朋友跟随小编一起看看吧
    2025-12-12
  • Golang 中的 json 编解码深度解析

    Golang 中的 json 编解码深度解析

    本文带领大家重新认识Golang中的json编解码,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2025-10-10
  • 详解golang consul-grpc 服务注册与发现

    详解golang consul-grpc 服务注册与发现

    这篇文章主要介绍了详解golang consul-grpc 服务注册与发现,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-06-06
  • golang执行命令操作 exec.Command

    golang执行命令操作 exec.Command

    这篇文章主要介绍了golang执行命令操作 exec.Command,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • golang协程与线程区别简要介绍

    golang协程与线程区别简要介绍

    这篇文章主要介绍了golang协程与线程区别简要介绍,进程是操作系统资源分配的基本单位,是程序运行的实例,线程是操作系统调度到CPU中执行的基本单位
    2022-06-06
  • go的defer和闭包示例说明(非内部实现)

    go的defer和闭包示例说明(非内部实现)

    这篇文章主要为大家介绍了go的defer和闭包示例说明(非内部实现),有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-08-08
  • Web框架Gin中间件实现原理步骤解析

    Web框架Gin中间件实现原理步骤解析

    这篇文章主要为大家介绍了Web框架Gin中间件实现原理步骤解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10
  • Golang应用程序性能优化技巧分享

    Golang应用程序性能优化技巧分享

    随着科技的进步,人人都想要快速的应用,这就需要优化您的应用程序性能。本文为大家整理了一些Golang应用程序性能优化的技巧,希望对大家有所帮助
    2023-04-04

最新评论