Rust / 系统课时
读写 TCP 连接
读写 TCP 连接
Tokio 的 TcpStream 同时提供异步读端和写端。真正需要做出的设计选择,是连接是否保持在一个任务中使用,还是拆成可独立移动的读半部和写半部并发处理;这直接决定应使用 split 还是 into_split。
学习目标
- 使用
TcpListener、TcpStream完成一次 TCP 连接与双向读写 - 区分
split返回的借用半部与into_split返回的拥有所有权半部 - 在需要独立任务并发读写时正确安排所有权与连接关闭
建立连接并完成读写
服务端通过 TcpListener::accept 得到 TcpStream,客户端通过 TcpStream::connect 建立连接。TCP 本身只提供字节流,不保留“消息”边界,因此示例使用换行符作为一条消息的结束标记。
下面的程序在本机绑定临时端口,服务端收到 ping 后返回 ack:ping。示例假定 Cargo 项目已添加 Tokio 1.x,并启用 full 特性。
use tokio::io::{self, AsyncBufReadExt, AsyncWriteExt, BufReader};
use tokio::net::{TcpListener, TcpStream};
#[tokio::main]
async fn main() -> io::Result<()> {
let listener = TcpListener::bind("127.0.0.1:0").await?;
let addr = listener.local_addr()?;
let server = tokio::spawn(async move {
let (mut socket, _) = listener.accept().await?;
// split 借用同一个 TcpStream,适合在当前任务作用域内分别读写。
let (read_half, mut write_half) = socket.split();
let mut reader = BufReader::new(read_half);
let mut line = String::new();
reader.read_line(&mut line).await?;
write_half
.write_all(format!("ack:{line}").as_bytes())
.await?;
write_half.shutdown().await?;
Ok::<(), io::Error>(())
});
let stream = TcpStream::connect(addr).await?;
// into_split 产生拥有所有权的半部,可以移动到独立的 spawned task。
let (read_half, mut write_half) = stream.into_split();
let writer = tokio::spawn(async move {
write_half.write_all(b"ping\n").await?;
write_half.shutdown().await
});
let reader = tokio::spawn(async move {
let mut reader = BufReader::new(read_half);
let mut line = String::new();
reader.read_line(&mut line).await?;
Ok::<String, io::Error>(line)
});
writer.await??;
let reply = reader.await??;
server.await??;
println!("client received: {}", reply.trim_end());
Ok(())
}预期输出
client received: ack:ping绑定地址中的端口由操作系统动态分配,实际值可视为 <PORT>;示例没有打印该值,因此不会影响预期输出。
split 与 into_split 的所有权差异
split(&mut stream) 返回借用的读半部和写半部,它们的生命周期受原始 TcpStream 约束,适合同一作用域内用 join!、select! 或顺序逻辑协调。由于普通 tokio::spawn 要求任务持有可独立存活的数据,借用半部通常不能直接移动到两个独立的 spawned task 中。
into_split(stream) 会消费原始 TcpStream,返回 OwnedReadHalf 与 OwnedWriteHalf。两个半部可以分别移动到独立任务,因此更适合读循环和写循环长期并发运行,但也会承担拥有型拆分所需的共享所有权管理成本。

处理并发与关闭
TCP 支持全双工读写,读任务等待数据时,写任务仍可继续发送。常见服务会让一个任务持续解析输入,另一个任务从通道接收待发送消息;这种结构下,into_split 更容易满足所有权要求。
调用写半部的 shutdown().await 表示本端不再发送更多数据,但读半部仍可继续接收对端数据。若只是丢弃一个拥有型半部,另一半仍可能保持连接资源,因此连接生命周期应由协议结束条件和任务退出路径共同控制。