Linux网络编程基础（错误处理）

不朽の燃梦

519人浏览 · 2026-05-25 00:05:13

不朽の燃梦 · 2026-05-25 00:05:13 发布

在Linux网络编程中，错误处理是确保程序健壮性和稳定性的关键环节。Socket编程中的错误处理涉及到多个层面，包括错误检测、错误码识别、异常恢复机制等。下面我将系统地介绍Socket错误处理的核心知识。

一、错误处理的基本机制

1.1 错误检测原则

在Linux系统中，大部分Socket系统调用在非正常返回时，其返回值为**-1**，并设置全局变量errno来指示具体的错误类型。errno存放一个正整数来表明上一个系统调用的错误值，仅当系统调用发生错误时才设置它。如果系统调用正常返回，它的值是不确定的。

核心原则：当一个系统调用发生错误时应立即检查errno的值，以避免下一个调用修改了errno的值。对于线程而言，每个线程都有专用的errno变量，因此不必考虑多线程同步问题。

1.2 错误信息输出函数

通常使用perror()函数来显示错误信息，它会将用户提供的字符串与当前errno对应的错误描述一起输出到标准错误流。也可以使用strerror(errno)获取错误描述字符串进行更灵活的处理。

int sockfd = socket(AF_INET, SOCK_STREAM, 0);
if (sockfd == -1) {
    perror("socket创建失败");
    // 或
    printf("错误原因: %s\n", strerror(errno));
    exit(EXIT_FAILURE);
}

二、常见Socket错误码详解

2.1 连接相关错误

错误码	数值	含义	触发场景
ECONNREFUSED	111	连接被拒绝	客户端尝试连接服务器时，目标服务器未监听或拒绝连接
ETIMEDOUT	110	连接超时	建立连接时超过设定超时时间，或服务器主机崩溃
ENETUNREACH	101	网络不可达	目标网络不可达，例如路由失败或网卡未启用
EHOSTUNREACH	113	主机不可达	无法找到到达主机的路由

ECONNREFUSED详解：当客户调用connect()函数发起TCP连接请求，而此时服务器端没有进程等待在相应的端口上（例如服务器未启动），远程系统会发回一个连接复位信号（RST），这时connect()函数将返回ECONNREFUSED错误码。

ETIMEDOUT详解：这种情况一般发生在服务器主机崩溃。此时客户TCP将在一定时间内持续重发数据分节，试图从服务TCP获得ACK分节。当最终放弃尝试后，内核将会向客户进程返回ETIMEDOUT错误。

2.2 数据传输错误

错误码	数值	含义	触发场景
EAGAIN	11	资源暂时不可用	非阻塞模式下操作无法立即完成
EWOULDBLOCK	11	操作将阻塞	等同于EAGAIN，非阻塞socket的常见情况
EINTR	4	系统调用被中断	阻塞操作被信号打断
EPIPE	32	管道破裂	向已关闭的socket写入数据
ECONNRESET	104	连接被重置	远程主机强制关闭连接
ENOTCONN	107	套接字未连接	在未连接的套接字上调用send或recv

2.3 资源与权限错误

错误码	数值	含义
EADDRINUSE	98	地址已被使用（端口占用）
EMFILE	24	进程文件描述符耗尽
ENFILE	23	系统文件描述符总数达到上限
EACCES	13	权限不足

三、核心函数错误处理详解

3.1 socket()函数

socket()成功返回非负文件描述符，失败返回-1并设置errno。常见错误：

EMFILE：进程打开文件数达到最大值（每进程限制，默认1024个）
ENFILE：系统总打开文件数达到上限
EACCES：权限不足，无法创建指定类型或协议的socket
ENOBUFS/ENOMEM：内存不足，无法创建socket

3.2 bind()函数

bind()成功返回0，失败返回-1。典型错误：

EADDRINUSE：地址已被使用。有时候出现close socket以后，重新bind出现此错误，可以通过调用setsockopt设置SO_REUSEADDR选项来解决：

int reuse = 1;
if (setsockopt(server_fd, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse)) == -1) {
    perror("setsockopt");
    exit(EXIT_FAILURE);
}

3.3 connect()函数

connect()成功返回0，失败返回-1。常见错误处理策略：

EADDRNOTAVAIL：远程地址无效，选择新的地址并重新连接或提示用户
ECONNREFUSED：连接被拒绝，等待一段时间后重试，仍无法连接则退出
EINTR：被信号中断，重新执行函数调用
ENETUNREACH：网络无法抵达，提示用户并退出运行
ETIMEDOUT：连接超时，提示用户并退出运行

3.4 accept()函数

accept()失败时返回-1。关键错误：

EAGAIN/EWOULDBLOCK：非阻塞socket且无连接可接受，继续等待即可
EINTR：被信号中断，重试即可
EMFILE/ENFILE：文件描述符耗尽，需要关闭一些连接

3.5 recv()与send()函数

recv()：返回0表示TCP连接已被关闭，返回-1表示出错。
send()：返回实际发送字节数，返回值小于要发送的数据数目时可能返回EAGAIN或EINTR。

EAGAIN处理：在非阻塞socket接收数据时经常出现Resource temporarily unavailable（errno代码11），表明在非阻塞模式下调用了阻塞操作。这个错误不会破坏socket的同步，下次循环接着recv就可以。对非阻塞socket而言，EAGAIN不是一种错误。

EPIPE处理：当向已关闭的连接写入数据时，会触发SIGPIPE信号，系统会将产生此EPIPE错误的进程杀死。所以一般在网络程序中，首先屏蔽此消息，以免发生进程被杀死的情况。可以使用MSG_NOSIGNAL标志来阻止信号产生：

ssize_t n = send(sockfd, buf, len, MSG_NOSIGNAL);
if (n == -1) {
    if (errno == EPIPE) {
        printf("对方已关闭连接\n");
        close(sockfd);
    }
}

四、错误处理最佳实践

4.1 错误分类与恢复策略

不是所有错误都值得重试，正确分类是设计重试逻辑的基础：

可恢复错误：EAGAIN、EINTR、EWOULDBLOCK - 可以重试
不可恢复错误：EPIPE、ECONNRESET、ECONNREFUSED - 需要关闭连接并清理资源

4.2 非阻塞模式的EAGAIN处理

在非阻塞socket上，当send()因EAGAIN失败时，表示写缓冲队列已满，可以做延时后再重试：

while (1) {
    ssize_t n = send(sockfd, buf, len, MSG_DONTWAIT);
    if (n >= 0) break;
    if (errno == EAGAIN) {
        usleep(1000); // 延时后重试
        continue;
    }
    perror("非阻塞send失败");
    break;
}

4.3 信号中断处理

若操作被信号中断（EINTR），通常需重新调用函数：

retry:
    if (accept(sockfd, NULL, NULL) == -1) {
        if (errno == EINTR) goto retry;
        perror("accept失败");
    }

4.4 使用setsockopt增强健壮性

通过设置socket选项，可以在发生错误时采取相应措施：

// 设置地址重用，避免"Address already in use"错误
int reuse = 1;
setsockopt(server_fd, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse));

// 启用保活机制，检测死连接
int keepalive = 1;
setsockopt(sockfd, SOL_SOCKET, SO_KEEPALIVE, &keepalive, sizeof(keepalive));

4.5 优雅的关闭连接

void graceful_close(int sockfd) {    
    // 关闭写端，发送FIN    
    if (shutdown(sockfd, SHUT_WR) == -1) {        
        perror("shutdown");    
    }        
    
    // 继续读取数据直到对端关闭    
    char buffer[1024];    
    while (recv(sockfd, buffer, sizeof(buffer), 0) > 0) {        
        // 丢弃接收到的数据    
    }        

    // 关闭socket    
    close(sockfd);
}