C / C++ / 系统课时
处理客户端异常断开连接
处理客户端异常断开连接
并发 TCP 服务端不能假设客户端总会正常结束。对端可能主动关闭、进程崩溃、网络中断,或在服务端回写前已经离线。本节按 recv 与 send 的真实返回语义处理这些分支,让单个异常连接只结束自己的工作线程,而不会拖垮整个进程。
学习目标
- 区分
recv返回正数、0 和 -1 时的处理方式 - 正确处理
EINTR、ECONNRESET、EPIPE等连接异常 - 避免写已断开的连接触发
SIGPIPE终止服务端
先按返回值分类
对阻塞式 TCP socket 调用 recv 时,返回值已经给出了第一层判断依据:大于 0 表示收到字节;等于 0 表示对端完成了有序关闭;小于 0 才需要查看 errno。

最重要的是不要把 recv == 0 当成错误。它表示 TCP 字节流已经读到 EOF,此后应结束该连接的业务循环并关闭本地描述符。
在工作线程中统一处理断开
下面是片段示例,依赖已有的 POSIX 线程式 TCP 服务端:client_fd 来自 accept,每个工作线程独占自己的客户端描述符。MSG_NOSIGNAL 是 Linux 上常用的做法,用来防止向已关闭连接写入时由 SIGPIPE 直接终止整个服务进程。
#include <errno.h>
#include <stdio.h>
#include <string.h>
#include <sys/socket.h>
#include <unistd.h>
static int send_all(int fd, const char *buf, size_t len) {
size_t sent = 0;
while (sent < len) {
ssize_t n = send(fd, buf + sent, len - sent, MSG_NOSIGNAL);
if (n > 0) {
sent += (size_t)n;
continue;
}
if (n < 0 && errno == EINTR) {
continue;
}
if (n < 0 && (errno == EPIPE || errno == ECONNRESET)) {
return 1;
}
return -1;
}
return 0;
}
void handle_client(int client_fd) {
char buf[4096];
for (;;) {
ssize_t n = recv(client_fd, buf, sizeof buf, 0);
if (n > 0) {
int rc = send_all(client_fd, buf, (size_t)n);
if (rc != 0) {
break;
}
continue;
}
if (n == 0) {
fprintf(stderr, "peer closed connection\n");
break;
}
if (errno == EINTR) {
continue;
}
if (errno == ECONNRESET) {
fprintf(stderr, "connection reset by peer\n");
break;
}
fprintf(stderr, "recv failed: %s\n", strerror(errno));
break;
}
close(client_fd);
}这段代码的生效行为是:短暂信号中断只重试当前系统调用;正常 EOF、连接重置和写入失败都会跳出循环,并最终只执行一次 close(client_fd)。若目标平台没有 MSG_NOSIGNAL,应采用平台支持的等价策略处理 SIGPIPE,不能直接假设该标志可移植到所有 POSIX 系统。
用正常 EOF 验证清理路径
服务端启动并监听实际端口后,可以先验证最稳定的“客户端发送数据后正常关闭”路径。将 <PORT> 替换为服务端实际监听端口。
printf 'hello\n' | nc 127.0.0.1 <PORT>预期结果:
客户端收到服务端回显 hello
服务端随后检测到 recv 返回 0,并结束该客户端的处理循环实际日志格式取决于你的服务端;关键验证点是服务进程仍继续运行,并且其他客户端仍可建立新连接。连接重置是否容易复现取决于客户端关闭方式和操作系统 TCP 状态,因此不要把固定某一条错误日志作为唯一验收条件。
写失败不能杀死整个进程
Linux 默认会在进程向已关闭的流式连接写入时产生 SIGPIPE。如果没有处理,默认动作可能终止整个服务端,这对多线程服务器尤其危险:一个异常客户端会让其他正常连接一起消失。
MSG_NOSIGNAL 把问题转化为当前 send 调用返回错误,随后由线程自己的清理逻辑处理。还要注意 send 可能只写入部分数据,因此示例使用 send_all 循环直到全部发送完,或在出现不可恢复错误时退出。
统一清理比到处 return 更安全
网络代码的异常分支很多,最容易出现的资源问题不是没判断错误,而是某条分支忘了关闭 fd、更新连接计数或释放每连接资源。把退出路径汇聚到统一清理位置,可以让 EOF、reset、写失败和普通业务结束共享同一套收尾动作。
如果该工作线程还维护共享的 active_clients,应在清理阶段配合互斥锁做一次成对减一。这样客户端异常断开只会终止自己的连接处理,不会留下泄漏的描述符、错误的共享状态,也不会影响其他线程继续服务。