C / C++ / 系统课时
跑通单连接回显服务
跑通单连接回显服务
这一节先不做连接池、回调或 Reactor 抽象,只实现一个最小单连接 Echo Server:客户端发什么,服务器就原样写回。通过实际观察 accept、read、write 和 close,建立后续拆分 Acceptor、Channel 与事件循环之前的行为基线。
学习目标
- 跑通一个只处理单个客户端的非阻塞 TCP 回显服务
- 识别
accept、read、write、close的完整连接路径 - 正确处理短写、对端关闭以及
EAGAIN
看清一次回显的连接路径
一次 Echo 同时涉及监听 Socket 和已连接 Socket。监听 Socket 只负责接入连接;accept 返回的新文件描述符才负责真正的数据收发。客户端有序关闭后,服务端 read 返回 0,这是 EOF,而不是系统调用失败。

为了避免没有事件时反复空转,示例使用 poll 等待监听 Socket 或连接 Socket 变为可读、可写。这里的 poll 只是等待手段,还没有引入 Reactor 的事件分发抽象。
实现最小 Echo Server
程序固定监听 127.0.0.1:9090,只接受一个客户端。连接建立后,每次最多读取 4096 字节,并把实际读到的数据完整写回。如果一次 write 没有发送完全部字节,就根据返回值继续发送剩余部分。
#include <arpa/inet.h>
#include <poll.h>
#include <signal.h>
#include <sys/socket.h>
#include <unistd.h>
#include <array>
#include <cerrno>
#include <cstring>
#include <iostream>
bool wait_for(int fd, short events) {
pollfd pfd{fd, events, 0};
while (true) {
int n = ::poll(&pfd, 1, -1);
if (n > 0) {
return true;
}
if (n == -1 && errno == EINTR) {
continue;
}
std::cerr << "poll failed: " << std::strerror(errno) << '\\n';
return false;
}
}
int main() {
// 避免对端提前关闭时 write 触发 SIGPIPE 直接终止进程。
::signal(SIGPIPE, SIG_IGN);
int listen_fd = ::socket(AF_INET, SOCK_STREAM | SOCK_NONBLOCK | SOCK_CLOEXEC, 0);
if (listen_fd == -1) {
std::cerr << "socket failed: " << std::strerror(errno) << '\\n';
return 1;
}
int reuse = 1;
if (::setsockopt(listen_fd, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse)) == -1) {
std::cerr << "setsockopt failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
sockaddr_in addr{};
addr.sin_family = AF_INET;
addr.sin_port = htons(9090);
if (::inet_pton(AF_INET, "127.0.0.1", &addr.sin_addr) != 1) {
std::cerr << "inet_pton failed\\n";
::close(listen_fd);
return 1;
}
if (::bind(listen_fd, reinterpret_cast<sockaddr*>(&addr), sizeof(addr)) == -1) {
std::cerr << "bind failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
if (::listen(listen_fd, SOMAXCONN) == -1) {
std::cerr << "listen failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
std::cout << "listening on 127.0.0.1:9090\\n";
if (!wait_for(listen_fd, POLLIN)) {
::close(listen_fd);
return 1;
}
int conn_fd = ::accept4(listen_fd, nullptr, nullptr, SOCK_NONBLOCK | SOCK_CLOEXEC);
if (conn_fd == -1) {
std::cerr << "accept4 failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
std::cout << "client connected\\n";
std::array<char, 4096> buffer{};
while (true) {
if (!wait_for(conn_fd, POLLIN)) {
break;
}
ssize_t n = ::read(conn_fd, buffer.data(), buffer.size());
if (n == 0) {
std::cout << "client closed\\n";
break;
}
if (n == -1) {
if (errno == EINTR || errno == EAGAIN || errno == EWOULDBLOCK) {
continue;
}
std::cerr << "read failed: " << std::strerror(errno) << '\\n';
break;
}
ssize_t sent = 0;
while (sent < n) {
ssize_t m = ::write(conn_fd, buffer.data() + sent,
static_cast<size_t>(n - sent));
if (m > 0) {
sent += m;
continue;
}
if (m == -1 && errno == EINTR) {
continue;
}
if (m == -1 && (errno == EAGAIN || errno == EWOULDBLOCK)) {
if (!wait_for(conn_fd, POLLOUT)) {
sent = -1;
break;
}
continue;
}
std::cerr << "write failed: " << std::strerror(errno) << '\\n';
sent = -1;
break;
}
if (sent == -1) {
break;
}
}
::close(conn_fd);
::close(listen_fd);
return 0;
}预期结果:服务器启动后进入等待;有一个客户端连接时开始回显数据;客户端关闭连接后,服务端观察到 EOF 并退出。
listening on 127.0.0.1:9090
client connected
client closed代码没有假设一次 write 就能写完全部数据。TCP 是字节流,系统调用的正返回值只表示“本次实际处理了多少字节”,因此程序使用 sent 保存发送进度。
编译并验证回显
先把程序保存为 echo_server.cpp,在终端 A 编译并启动服务器:
g++ -std=c++20 -Wall -Wextra -pedantic echo_server.cpp -o echo_server && ./echo_server预期输出:
listening on 127.0.0.1:9090再在终端 B 使用常见的 nc 客户端发送一行文本:
printf 'hello echo\n' | nc 127.0.0.1 9090预期输出:
hello echo终端 A 在连接建立并关闭后还会出现下面两行:
client connected
client closed如果 9090 已经被其他进程占用,bind 会失败并报告 Address already in use。这类错误不是“稍后就一定能成功”的非阻塞重试状态,应释放端口或改用其他未占用端口。
读懂四个关键调用
accept4 成功后返回一个新的连接文件描述符,原来的监听文件描述符仍保持打开。示例使用 SOCK_NONBLOCK 和 SOCK_CLOEXEC 创建已连接 Socket,使它从产生时就具备需要的文件状态。
read 返回正数表示本次读取到的字节数量;返回 0 表示对端已经有序关闭发送方向;返回 -1 时才结合 errno 继续判断。EINTR、EAGAIN 和 EWOULDBLOCK 在这里都不应该直接当成连接损坏。
write 返回正数表示本次实际写出的字节数,而且这个值可能小于要求发送的长度。非阻塞 Socket 的发送缓冲区暂时没有空间时,write 可以返回 -1 并设置 EAGAIN 或 EWOULDBLOCK,示例随后等待 POLLOUT 再继续。
close 释放当前进程持有的文件描述符引用。这个单连接程序先关闭 conn_fd,再关闭 listen_fd,于是监听与连接两条资源路径都得到回收。
当客户端输入能够稳定原样返回,并且你能解释连接建立、正常读写、短写、EOF 与关闭分别对应什么返回值时,这个最小 Echo Server 就已经成为后续网络库抽象可靠的行为基线。