3. Socket API概览：常用Socket函数及其参数与返回值

Socket API是网络编程的基石，它屏蔽了底层TCP/IP协议的复杂性，为开发者提供了一套统一的、基于文件描述符的接口。无论是构建高并发的Web服务器、实时通信系统，还是简单的网络工具，掌握这些核心函数的语义、参数细节和返回值处理都是必备技能。本章将系统梳理从创建套接字到关闭连接的全生命周期中，最常用的八个函数：socket、bind、listen、accept、connect、send、recv和close，并深入剖析其背后的状态机变化与工程实践要点。

上图展示了TCP协议下，客户端与服务器端调用Socket API的典型时序关系。服务器端遵循“socket→bind→listen→accept→recv/send→close”的固定模式，而客户端则遵循“socket→connect→send/recv→close”的简化流程。理解这张图是掌握本章后续所有细节的基础。

3.1 核心原理：从文件描述符到网络通信

Socket API的设计哲学是“一切皆文件”。在Linux/Unix系统中，socket()函数返回的是一个整数类型的文件描述符（fd），后续所有操作（如绑定、监听、收发数据）都通过这个fd进行。这种设计使得网络I/O可以复用文件I/O的许多机制，例如使用select()、poll()或epoll()进行多路复用监控。

从内核角度看，一个socket代表了一条通信链路的一个端点。它由协议族（domain）、服务类型（type）和具体协议（protocol）三个维度唯一确定。当调用socket()时，内核会分配相应的网络缓冲区、协议控制块等资源，并返回一个最小的未使用fd。值得注意的是，fd的分配遵循“最小可用”原则，即优先复用已被关闭的fd编号。

在TCP/IP协议栈中，socket层位于应用层与传输层之间。应用层通过send()将数据拷贝到内核发送缓冲区，由TCP协议负责分段、排序、重传；接收方向则相反，内核将完整的数据段拷贝到接收缓冲区，应用层通过recv()读取。这种缓冲机制决定了send()和recv()的返回值并不总是等于应用层请求的字节数，这是初学者最容易困惑的地方。

3.2 函数详解：参数、返回值与典型错误

下面逐一剖析每个核心函数的签名、参数语义、返回值及常见错误码。为便于对照，先给出总览表：

3.2.1 socket()：一切通信的起点

int socket(int domain, int type, int protocol)的三个参数分别指定协议族、套接字类型和具体协议。常用的domain有AF_INET（IPv4）、AF_INET6（IPv6）和AF_UNIX（本地通信）；type常用SOCK_STREAM（流式，对应TCP）和SOCK_DGRAM（数据报，对应UDP）。protocol通常设为0，表示由内核根据domain和type自动选择默认协议。

一个常见的误区是混淆AF_INET与PF_INET。在绝大多数现代系统中，二者等价，但语义上AF_表示地址族，PF_表示协议族。建议统一使用AF_前缀。

3.2.2 bind()：为套接字命名

int bind(int fd, const struct sockaddr *addr, socklen_t addrlen)将地址结构体与fd绑定。对于服务器端，这是必须的步骤，用于指定监听的IP和端口。对于客户端，通常不需要显式调用bind，内核会在connect()时自动分配临时端口。

地址结构体需要根据协议族进行类型转换。IPv4使用struct sockaddr_in，IPv6使用struct sockaddr_in6。一个典型的IPv4绑定示例：

struct sockaddr_in serv_addr;
memset(&serv_addr, 0, sizeof(serv_addr));
serv_addr.sin_family = AF_INET;
serv_addr.sin_addr.s_addr = htonl(INADDR_ANY);  // 监听所有网卡
serv_addr.sin_port = htons(8080);
if (bind(listen_fd, (struct sockaddr*)&serv_addr, sizeof(serv_addr)) == -1) {
    perror("bind failed");
    exit(EXIT_FAILURE);
}

注意htonl()和htons()用于主机字节序到网络字节序的转换。端口号0表示让内核随机分配一个可用端口，这在某些RPC场景中很有用。

3.2.3 listen()：进入被动监听

int listen(int fd, int backlog)将主动套接字转换为被动监听套接字。backlog参数指定内核维护的连接队列的最大长度。这个队列包含已完成三次握手但尚未被accept()取走的连接。在Linux 2.2之后，backlog表示“完全连接队列”的长度，而非“半连接队列”。

backlog的值并非越大越好。过大的backlog会占用内核内存，且当队列满时，新的连接请求会被拒绝（客户端收到ECONNREFUSED）。对于高并发服务器，建议结合somaxconn系统参数调整，通常设置为128~1024之间。

3.2.4 accept()：接受连接并创建新fd

int accept(int fd, struct sockaddr *addr, socklen_t *addrlen)从监听队列中取出一个已完成握手的连接，并返回一个全新的fd。这个新fd专门用于与对应客户端通信，而原监听fd继续监听新的连接请求。addr和addrlen是输出参数，用于获取客户端的地址信息，如果不关心可设为NULL。

accept()是阻塞调用，如果没有新连接，进程会睡眠直到有连接到达。在多线程或事件驱动模型中，通常每个新fd由一个线程或事件处理器负责。

3.2.5 connect()：主动发起连接

int connect(int fd, const struct sockaddr *addr, socklen_t addrlen)用于客户端向服务器发起连接。对于TCP，该函数触发三次握手过程。connect()也是阻塞的，默认超时时间约为75秒（由内核参数tcp_syn_retries决定）。

常见的失败场景包括：服务器未监听（ECONNREFUSED）、网络不可达（ENETUNREACH）、连接超时（ETIMEDOUT）。对于非阻塞socket，connect()通常会返回EINPROGRESS，表示连接正在建立中，需要后续通过select()或poll()检查是否成功。

3.2.6 send()与recv()：数据传输的核心

ssize_t send(int fd, const void *buf, size_t len, int flags)和ssize_t recv(int fd, void *buf, size_t len, int flags)是数据收发的核心。flags参数通常设为0，但也可以组合MSG_DONTWAIT（非阻塞）、MSG_PEEK（窥探数据不取出）等。

send()的返回值表示实际写入内核发送缓冲区的字节数，可能小于len。当缓冲区满时，阻塞模式下send()会等待；非阻塞模式下返回-1并设置errno为EAGAIN。另一个重要错误是EPIPE，表示对端已关闭连接，此时进程还会收到SIGPIPE信号（默认终止进程），因此生产代码中通常需要忽略SIGPIPE或使用MSG_NOSIGNAL标志。

recv()的返回值有特殊语义：返回0表示对端已正常关闭连接（四次挥手完成）；返回正数表示实际接收的字节数；返回-1表示出错。与send()类似，非阻塞模式下可能返回EAGAIN。recv()返回0是判断连接关闭的唯一可靠方式，不能依赖errno。

3.2.7 close()：释放资源

int close(int fd)关闭一个fd。对于TCP连接，close()会触发四次挥手。但需要注意，close()只是将fd的引用计数减1，只有当引用计数变为0时才真正关闭连接。在多线程或多进程模型中，如果多个fd指向同一个socket，需要所有fd都close后连接才会断开。

另一个重要概念是shutdown()函数，它比close()更精细，可以单独关闭读方向或写方向。例如，shutdown(fd, SHUT_WR)发送FIN包表示“我发完了”，但还可以继续接收数据。这在实现HTTP/1.1的半关闭场景中非常有用。

3.3 实战场景：构建一个简易回声服务器

为了将上述函数串联起来，我们实现一个经典的TCP回声服务器：客户端发送什么，服务器就原样返回什么。这个案例虽然简单，但涵盖了所有核心API的调用时机和错误处理。

场景约束：单线程阻塞模型，服务器监听127.0.0.1:9000，最多同时服务1个客户端（串行处理）。目标是验证API调用的正确性，不追求并发性能。

服务器端代码框架：

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <arpa/inet.h>
#include <sys/socket.h>

#define PORT 9000
#define BUFFER_SIZE 1024

int main() {
    int listen_fd, conn_fd;
    struct sockaddr_in serv_addr, cli_addr;
    socklen_t cli_len = sizeof(cli_addr);
    char buffer[BUFFER_SIZE];
    ssize_t n;

    // 1. 创建socket
    listen_fd = socket(AF_INET, SOCK_STREAM, 0);
    if (listen_fd < 0) { perror("socket"); exit(1); }

    // 2. 设置端口复用（避免TIME_WAIT问题）
    int opt = 1;
    setsockopt(listen_fd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));

    // 3. bind
    memset(&serv_addr, 0, sizeof(serv_addr));
    serv_addr.sin_family = AF_INET;
    serv_addr.sin_addr.s_addr = htonl(INADDR_ANY);
    serv_addr.sin_port = htons(PORT);
    if (bind(listen_fd, (struct sockaddr*)&serv_addr, sizeof(serv_addr)) < 0) {
        perror("bind"); exit(1);
    }

    // 4. listen
    if (listen(listen_fd, 5) < 0) { perror("listen"); exit(1); }
    printf("Echo server listening on port %d\n", PORT);

    while (1) {
        // 5. accept
        conn_fd = accept(listen_fd, (struct sockaddr*)&cli_addr, &cli_len);
        if (conn_fd < 0) { perror("accept"); continue; }
        printf("Client connected: %s:%d\n", inet_ntoa(cli_addr.sin_addr), ntohs(cli_addr.sin_port));

        // 6. 回声循环
        while ((n = recv(conn_fd, buffer, BUFFER_SIZE, 0)) > 0) {
            send(conn_fd, buffer, n, 0);  // 原样返回
        }
        if (n == 0) {
            printf("Client closed connection\n");
        } else {
            perror("recv error");
        }

        // 7. close
        close(conn_fd);
    }

    close(listen_fd);
    return 0;
}

客户端代码关键片段：

int sock_fd = socket(AF_INET, SOCK_STREAM, 0);
struct sockaddr_in serv_addr = {0};
serv_addr.sin_family = AF_INET;
serv_addr.sin_port = htons(9000);
inet_pton(AF_INET, "127.0.0.1", &serv_addr.sin_addr);

if (connect(sock_fd, (struct sockaddr*)&serv_addr, sizeof(serv_addr)) < 0) {
    perror("connect"); exit(1);
}

char *msg = "Hello, Socket!";
send(sock_fd, msg, strlen(msg), 0);
char buf[1024] = {0};
recv(sock_fd, buf, sizeof(buf), 0);
printf("Echo: %s\n", buf);
close(sock_fd);

运行结果与分析：启动服务器后，运行客户端，控制台输出Echo: Hello, Socket!。这个案例验证了以下关键点：

• accept()返回的conn_fd与listen_fd是独立的，关闭conn_fd不影响继续监听。
• recv()返回0时表示客户端正常关闭，此时应结束循环并close。
• 如果不设置SO_REUSEADDR，服务器重启时可能因TIME_WAIT状态导致bind失败。

3.4 常见误区与总结复盘

以下是初学者在使用Socket API时最常犯的错误，务必引以为戒：

总结复盘：本章的八个函数构成了TCP网络编程的最小完备集。掌握它们的关键在于理解三个核心概念：文件描述符的生命周期（从socket创建到close释放）、阻塞与非阻塞的语义差异（影响所有调用的返回值行为）、缓冲区与字节流边界（TCP是流协议，没有消息边界）。建议读者在本地亲手运行上述回声服务器案例，并尝试修改参数（如将backlog设为1、去掉SO_REUSEADDR）观察行为变化，这比死记硬背函数签名有效得多。