操作系统 / 系统课时

用 errno 判断网络调用失败

用 errno 判断网络调用失败

网络系统调用失败时,真正决定下一步动作的不是“返回了 -1”,而是紧随其后的 errno。本文把 connect、accept、recv、send 的常见失败整理成可重试、等待事件、关闭连接和资源故障四类,并用可运行示例验证两个最典型分支。

学习目标

  • 正确读取并保存 errno,避免把成功调用后的残留值当成错误。
  • 区分 EAGAIN、EINPROGRESS、EINTR 与断链类错误的处理方式。
  • 为 connect、accept、recv、send 建立稳定的错误分流顺序。

先把 errno 用对

大多数 Linux Socket 系统调用以返回值报告是否失败:返回 -1 时再读取 errno。errno 是线程局部状态,但后续库函数或系统调用可能改写它,因此需要在失败分支里立刻保存,例如 int saved_errno = errno;。

反过来,不要在调用成功后检查 errno。成功的系统调用没有义务把它清零,所以一个旧错误值可能仍然存在。recv 返回 0 也不是 errno 错误,而是对端完成了有序关闭;send 或 recv 返回正数但小于请求长度则是部分完成,同样不能按失败处理。

按调用区分典型错误

调用 典型状态 含义 常见动作
connect EINPROGRESS 非阻塞连接仍在建立 等待可写,再读取 SO_ERROR
connect ECONNREFUSED、ETIMEDOUT、ENETUNREACH 目标拒绝、超时或路由不可达 结束本次连接,按策略退避重试
accept EAGAIN/EWOULDBLOCK 当前没有已完成连接 返回事件循环等待下一次可读
accept EMFILE/ENFILE 进程或系统文件描述符耗尽 限流、释放资源并告警,禁止忙等
recv EAGAIN/EWOULDBLOCK 非阻塞 Socket 暂无数据 保留连接,等待下一次可读
recv ECONNRESET 对端异常重置连接 清理连接状态并关闭
send EAGAIN/EWOULDBLOCK 发送缓冲区暂时不可继续写 保存未发送部分,等待可写
send EPIPE、ECONNRESET 对端已关闭或连接已失效 停止发送并关闭连接

EINTR 需要单独看待:它表示调用被信号中断,很多读写类调用可以在没有产生进度时重试;但 connect 的状态处理更微妙,工程上通常使用非阻塞连接,再通过就绪事件和 SO_ERROR 判断最终结果,而不是简单重复调用 connect。

用可运行示例观察两个分支

下面的程序用 socketpair 创建一对已连接 Socket。第一步把一端设为非阻塞并在“无数据”时调用 recv,应得到可等待的 EAGAIN/EWOULDBLOCK;第二步关闭对端,再用 MSG_NOSIGNAL 调用 send,应得到需要结束连接的 EPIPE。

bash
cat > /tmp/errno_socket_demo.c <<'EOF'
#include <sys/socket.h>
#include <errno.h>
#include <fcntl.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>

int main(void) {
    int sv[2];
    if (socketpair(AF_UNIX, SOCK_STREAM, 0, sv) == -1) {
        perror("socketpair");
        return 1;
    }

    int flags = fcntl(sv[0], F_GETFL, 0);
    if (flags == -1 || fcntl(sv[0], F_SETFL, flags | O_NONBLOCK) == -1) {
        perror("fcntl");
        return 1;
    }

    char ch;
    /* No data is pending: nonblocking recv should tell us to wait. */
    ssize_t n = recv(sv[0], &ch, 1, 0);
    if (n == -1) {
        int saved_errno = errno;
        if (saved_errno == EAGAIN || saved_errno == EWOULDBLOCK) {
            puts("recv: retry later (EAGAIN/EWOULDBLOCK)");
        } else {
            fprintf(stderr, "recv: unexpected error: %s\n",
                    strerror(saved_errno));
            return 1;
        }
    }

    close(sv[1]);
    /* Expose EPIPE as a return value instead of terminating via SIGPIPE. */
    n = send(sv[0], "x", 1, MSG_NOSIGNAL);
    if (n == -1) {
        int saved_errno = errno;
        if (saved_errno == EPIPE) {
            puts("send: peer closed (EPIPE)");
        } else {
            fprintf(stderr, "send: unexpected error: %s\n",
                    strerror(saved_errno));
            return 1;
        }
    }

    close(sv[0]);
    return 0;
}
EOF
cc -Wall -Wextra -O2 /tmp/errno_socket_demo.c -o /tmp/errno_socket_demo
/tmp/errno_socket_demo

预期输出:

text
recv: retry later (EAGAIN/EWOULDBLOCK)
send: peer closed (EPIPE)

这里使用 MSG_NOSIGNAL 是为了让 send 在对端关闭后返回 EPIPE,而不是让默认的 SIGPIPE 直接终止进程。服务器也可以统一忽略或处理 SIGPIPE,但应选定一种策略并保持一致。

在事件循环里按顺序分流

错误处理最好围绕“当前操作是否还能继续”来组织,而不是写一个巨大的 switch(errno)。先判断调用是否真的失败,再立即保存 errno;随后区分等待条件、连接建立中的中间状态、可安全重试的中断以及连接已失效或资源已耗尽的错误。

Socket errno 处理决策流程

非阻塞 connect 最容易误判:Socket 变为“可写”只代表连接尝试结束,不代表一定成功。此时应调用 getsockopt(fd, SOL_SOCKET, SO_ERROR, ...);返回的错误值为 0 才表示连接成功,否则该值就是连接失败原因。

不要把所有错误都做成重试

EAGAIN/EWOULDBLOCK 的正确动作通常是等待就绪事件后再继续,忙循环重试只会烧 CPU。EINPROGRESS 也不是“立刻再 connect 一次”,而是等待连接完成。EPIPE、ECONNRESET、ENOTCONN 则说明这条连接已经不适合继续读写,应释放与连接绑定的业务状态。

EMFILE、ENFILE、ENOBUFS 更接近容量或资源故障。此时如果仍然高速 accept 或重连,会放大故障;更合理的做法是限流、退避、释放资源并告警。把错误分成“等待后继续、状态确认、关闭连接、资源治理”四类,网络错误处理会比单纯记忆 errno 数字稳定得多。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 errno 判断网络调用失败

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通