P2P 与分布式存储 / 系统课时
一条连接如何复用多个协议流
一条连接如何复用多个协议流
建立 libp2p 对等连接后,消息回声与状态查询不必分别建立 TCP 连接。本篇使用 Go 在本机运行两个 Host,注册两种协议处理器,并通过连接计数验证:多个 Stream 可以共用一条安全连接,而关闭 Stream 与断开对等连接是两件事。
学习目标
- 区分底层连接、流复用器、Stream 与协议标识。
- 为两个协议 ID 注册处理器,在同一连接上收发独立消息。
- 验证关闭单条流、关闭所有业务流及关闭 Peer 连接后的行为。
连接和协议流是什么关系
本例采用 TCP 传输,Host A 与 Host B 先建立经过 Noise 或 TLS 1.3 保护的连接,再由默认的 yamux 复用器承载多条逻辑流。/demo/echo/1.0.0 与 /demo/status/1.0.0 是应用层协议标识,用于把新 Stream 分发到对应处理器;它们不是新端口,也不是两次独立的安全握手。
每条 network.Stream 都能独立读写和关闭。同一连接上的不同流有各自的数据与生命周期,但共享底层传输:一条流正常结束不要求关闭连接,底层连接断开却会影响其上的所有流。

注册处理器并打开两条流
环境采用 Go 1.26 或更新版本、github.com/libp2p/go-libp2p v0.50.0。实验仅监听回环地址,端口号 0 表示由操作系统分配空闲端口,因此无需公网 IP 或 NAT 配置。先建立模块:
mkdir p2p-stream-lab
cd p2p-stream-lab
go mod init example.com/p2p-stream-lab
go get github.com/libp2p/go-libp2p@v0.50.0预期结果:生成 go.mod 和 go.sum,依赖解析成功;下载过程的版本和进度日志随环境变化。把下面完整程序保存为 main.go:
package main
import (
"bufio"
"context"
"fmt"
"strings"
"time"
libp2p "github.com/libp2p/go-libp2p"
"github.com/libp2p/go-libp2p/core/network"
"github.com/libp2p/go-libp2p/core/peer"
"github.com/libp2p/go-libp2p/core/protocol"
)
const (
echoID protocol.ID = "/demo/echo/1.0.0"
statusID protocol.ID = "/demo/status/1.0.0"
)
func serve(name string) network.StreamHandler {
return func(s network.Stream) {
defer s.Close()
line, err := bufio.NewReader(s).ReadString('\n')
if err != nil {
_ = s.Reset()
return
}
// 每种协议各自处理消息,不共享业务数据缓冲区。
if _, err := fmt.Fprintln(s, name+":"+strings.TrimSpace(line)); err != nil {
_ = s.Reset()
}
}
}
func exchange(s network.Stream, request string) (string, error) {
// 限定请求的读写等待,避免测试在异常连接上无限阻塞。
if err := s.SetDeadline(time.Now().Add(5 * time.Second)); err != nil {
return "", err
}
if _, err := fmt.Fprintln(s, request); err != nil {
return "", err
}
return bufio.NewReader(s).ReadString('\n')
}
func must(err error) {
if err != nil {
panic(err)
}
}
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
a, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
must(err)
defer a.Close()
b, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
must(err)
defer b.Close()
b.SetStreamHandler(echoID, serve("echo"))
b.SetStreamHandler(statusID, serve("status"))
must(a.Connect(ctx, peer.AddrInfo{ID: b.ID(), Addrs: b.Addrs()}))
count := func() int { return len(a.Network().ConnsToPeer(b.ID())) }
fmt.Println("建连后连接数:", count())
// 两条流均已打开,随后分别请求和关闭。
echo, err := a.NewStream(ctx, b.ID(), echoID)
must(err)
status, err := a.NewStream(ctx, b.ID(), statusID)
must(err)
result, err := exchange(echo, "ping")
must(err)
fmt.Println("回声流:", strings.TrimSpace(result))
must(echo.Close())
fmt.Println("关闭回声流后连接数:", count())
result, err = exchange(status, "check")
must(err)
fmt.Println("状态流:", strings.TrimSpace(result))
must(status.Close())
fmt.Println("关闭两条流后连接数:", count())
// 同一 Peer 再开新流,不需要重新建立底层连接。
again, err := a.NewStream(ctx, b.ID(), statusID)
must(err)
result, err = exchange(again, "again")
must(err)
fmt.Println("重开状态流:", strings.TrimSpace(result))
must(again.Close())
fmt.Println("再次复用后连接数:", count())
must(a.Network().ClosePeer(b.ID()))
fmt.Println("关闭对等连接后连接数:", count())
}保存后执行:
go run .预期输出(首次获取依赖的下载日志不计入程序输出):
建连后连接数: 1
回声流: echo:ping
关闭回声流后连接数: 1
状态流: status:check
关闭两条流后连接数: 1
重开状态流: status:again
再次复用后连接数: 1
关闭对等连接后连接数: 0读懂关闭行为并处理异常
echo.Close() 只结束回声流;已打开的状态流仍能返回 status:check。两条业务流都关闭后,底层连接在本次实验中仍为 1,因此第三次 NewStream 能复用它。Network().ClosePeer(b.ID()) 才会关闭 A 到 B 的现有连接,计数归零;若当时仍有活跃流,其读写也会受影响。
容易混淆的三个边界可以直接用这个程序检查:
- 协议不匹配:把 A 的
statusID换成 B 未注册的协议 ID,NewStream在协议协商阶段返回错误;不是 TCP 必然断开。协议标识包含版本段,双方须约定匹配的标识。 - 等待消息结束:处理器通过
ReadString('\n')判断一条请求是否完整。发送方漏掉换行时会等待直到收到分隔符、EOF 或期限届满;生产环境应定义明确的帧格式和长度限制。 - 正常关闭与异常中断:请求响应完成后用
Close()释放流;只结束发送、还需继续读响应时用CloseWrite();发生无法继续解析的数据错误时用Reset()。这三个 API 不应互换。
如果只想停掉一个业务协议,关闭属于该协议的 Stream 即可;不要为了结束一次请求调用 ClosePeer,否则同一对等连接上其他协议的通信也会被切断。