NATS Streaming通过消息持久化和可靠传递保障Golang应用消息不丢失,核心步骤包括:1. 用Docker部署NATS Streaming服务器;2. 安装stan.go客户端库;3. 使用stan.Connect()建立连接并指定唯一客户端ID;4. 通过Publish()发布消息,支持同步与异步模式;5. 使用Subscribe()实现广播、QueueSubscribe()实现负载均衡消费;6. 通过持久化ID实现断线重连后消息续传。尽管NATS Streaming仍用于部分存量系统,新项目建议优先评估JetStream。

NATS Streaming 为 NATS 提供了消息持久化、可靠传递和历史消息回放等企业级特性,非常适合需要确保消息不丢失的 Golang 应用场景。虽然 NATS Streaming 已被 JetStream 取代,但仍有存量系统在使用。以下是 Golang 集成 NATS Streaming 的关键步骤和要点。
安装 NATS Streaming 服务器与客户端
要使用 NATS Streaming,你需要部署服务器并引入对应的 Go 客户端库。
-
启动 NATS Streaming 服务器:可以使用 Docker 快速部署,例如
docker run -d -p 4222:4222 -p 8222:8222 nats-streaming:latest
。NATS Streaming 通常作为 NATS Server 的一个模块运行。 -
安装 Go 客户端:在你的 Golang 项目中执行
go get github.com/nats-io/stan.go
来获取 NATS Streaming 的官方 Go 客户端。
建立连接与发布消息
连接到 NATS Streaming 服务器并发布消息是基础操作,需要指定一个集群 ID 和客户端 ID。
-
创建连接:使用
stan.Connect()
函数,传入集群 ID(如 "test-cluster")、唯一的客户端 ID 和连接选项。客户端 ID 必须在同一个集群中唯一,用于标识订阅者。 -
发布消息:通过连接对象的
Publish()
方法向特定主题发送数据。该方法支持同步和异步两种模式。异步发布可以提供一个确认回调函数来处理发送成功或失败的情况,提升应用的健壮性。
订阅消息处理
NATS Streaming 提供了多种订阅模式来满足不同的消息处理需求,核心是确保消息的可靠接收。
立即学习“go语言免费学习笔记(深入)”;
-
普通订阅:使用
Subscribe()
。每次消息发布后,所有匹配的订阅者都会收到该消息的副本,适用于广播场景。 -
队列订阅:使用
QueueSubscribe()
。同一队列组内的多个订阅者会共享消息流,每条消息只会被其中一个成员消费,这非常适合负载均衡和并行处理任务。 - 持久化与重连:为订阅指定一个持久化 ID(Durable Name),服务器会为该订阅者存储未确认的消息。即使订阅者断开连接,当它以相同的持久化 ID 重新连接时,可以继续接收断线期间错过的消息,保证了消息的不丢失。
基本上就这些核心操作。注意 NATS Streaming 的设计哲学是将复杂性留在客户端,因此正确处理连接、订阅和确认逻辑至关重要。对于新项目,建议评估其继任者 JetStream。










