《getaddrinfo() —— Linux 网络编程的地址解析函数》

前言：写网络程序时，你是不是还在用gethostbyname()？它不可重入、不支持 IPv6，早已被 POSIX 标记为废弃。今天我们来深入解析它的替代者——getaddrinfo()，一个真正现代化的地址解析函数。

想象一下，你要写一个 TCP 服务器，希望同时支持IPv4和IPv6。如果使用传统的gethostbyname()，你只能得到一个固定的地址结构，无法同时处理两种协议族。

如果用手动方式，比如先填 sockaddr_in（IPv4）或 sockaddr_in6（IPv6），再调用inet_pton()转换地址——那你的代码就会被某个协议族绑定死。

Linux 提供了一套优雅的解决方案 —— getaddrinfo()。这个函数就像一位 "网络地址翻译官" 。只需要告诉它你想要什么（主机名、服务名、协议类型、地址族偏好等），它会把所有满足条件的地址结构体准备好，以链表形式返回。你只需要遍历这个链表，找到能成功创建套接字的那一个即可。

总结：getaddrinfo()让你写出协议无关（Protocol -Independent）的网络程序。

1
2
3
4
5
6
#include <netdb.h>int getaddrinfo(const char *restrict node,                const char *restrict service,                const struct addrinfo *restrict hints,                struct addrinfo **restrict res);

返回值：成功返回 0，失败返回非零错误码（可调用  gai_strerror()  函数转换为可读信息）。

⚠️ 重要：getaddrinfo() 会动态分配内存来存储返回的链表。当你不再需要时，必须调用 freeaddrinfo(res) 释放。

1
2
3
4
5
6
7
8
9
10
struct addrinfo {     int ai_flags;                             // 附加选项     int ai_family;                          // 地址族：AF_INET / AF_INET6 / AF_UNSPEC     int ai_socktype;                      // 套接字类型：SOCK_STREAM / SOCK_DGRAM     int ai_protocol;                       // 协议：通常填0     socklen_t ai_addrlen;              // 地址结构长度struct sockaddr *ai_addr;       // 真正的套接字地址结构（这是关键！）     char  *ai_canonname;            // 规范主机名struct addrinfo *ai_next;       // 链表指针，指向下一个地址};

💡 核心理解：ai_addr 是一个 struct sockaddr * 指针，它实际上可能指向 sockaddr_in（IPv4）或 sockaddr_in6（IPv6）。不需要关心具体类型，直接把它传给 socket()、bind()、connect() 即可。

hints 参数是一个 addrinfo 结构体，它的作用是过滤返回结果。不需要填满所有字段，只需设置关心的条件，其余字段置 0 或 NULL。

如果 hints == NULL，相当于采用了如下默认配置：

1
2
3
4
ai_family   = AF_UNSPEC;            // IPv4 和 IPv6 都接受ai_socktype = 0;                    // 任意类型ai_protocol = 0;                    // 任意协议ai_flags    = AI_V4MAPPED | AI_ADDRCONFIG;

ai_flags 是 hints 中最核心的字段，直接决定了 getaddrinfo()  的行为逻辑。

AI_PASSIVE —— 服务器端专用（被动）作用：返回适合 bind() 的地址，用于监听（ listen() + accept() ）。配合： node == NULL：返回通配符地址（ IPv4 为 INADDR_ANY，IPv6 为 IN6ADDR_ANY_INIT ）。这意味着套接字会监听本机所有可用的网络接口。适用场景：服务器程序。

未设置 AI_PASSIVE —— 客户端专用（主动）作用：返回适合 connect() 的地址。配合： node == NULL：返回环回地址（ IPv4 为 127.0.0.1，IPv6 为 ::1 ）。适用场景：客户端程序，或同一主机上的进程间通信。

场景一：服务端监听

场景二：客户端连接

嵌入式开发者注意：DNS 解析在弱网环境下可能耗时数秒甚至超时。如果你已知目标 IP，设置 AI_NUMERICHOST 可以避免不必要的 DNS 查询，既提升性能又增强可靠性。

下面是使用 getaddrinfo() 的完整服务端代码（UDP 回显服务）。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
#define BUF_SIZE 500int main(int argc, char *argv[]){    int sfd, s;    char buf[BUF_SIZE];    ssize_t nread;    socklen_t peer_addrlen;struct addrinfo hints;struct addrinfo *result, *rp;struct sockaddr_storage peer_addr;    if (argc != 2) {        fprintf(stderr, "Usage: %s port\n", argv[0]);        exit(EXIT_FAILURE);    }    // 1. 配置 hints：我们要一个 UDP 被动套接字    memset(&hints, 0, sizeof(hints));    hints.ai_family = AF_UNSPEC;      // IPv4 或 IPv6 都行    hints.ai_socktype = SOCK_DGRAM;   // UDP 数据报    hints.ai_flags = AI_PASSIVE;      // 通配符地址（被动监听）    hints.ai_protocol = 0;    // 2. 解析地址    s = getaddrinfo(NULL, argv[1], &hints, &result);    if (s != 0) {        fprintf(stderr, "getaddrinfo: %s\n", gai_strerror(s));        exit(EXIT_FAILURE);    }    // 3. 遍历地址链表，尝试创建套接字并绑定    for (rp = result; rp != NULL; rp = rp->ai_next) {        sfd = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol);        if (sfd == -1)            continue;        if (bind(sfd, rp->ai_addr, rp->ai_addrlen) == 0)            break;  // 绑定成功        close(sfd);    }    freeaddrinfo(result);  // ⚠️ 释放链表内存    if (rp == NULL) {        fprintf(stderr, "Could not bind\n");        exit(EXIT_FAILURE);    }    // 4. 回显数据报循环（省略具体收发逻辑）    // ...}

🔍 为什么要遍历链表：getaddrinfo() 可能返回多个地址（例如系统同时支持 IPv4 和 IPv6）。这段代码会依次尝试，直到找到一个能成功 socket() + bind() 的地址。这种写法让程序自动适配底层的网络协议栈。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
#define BUF_SIZE 500int main(int argc, char *argv[]){    int sfd, s;struct addrinfo hints;struct addrinfo *result, *rp;    if (argc < 3) {        fprintf(stderr, "Usage: %s host port msg...\n", argv[0]);        exit(EXIT_FAILURE);    }    // 1. 配置 hints：客户端，不设 AI_PASSIVE    memset(&hints, 0, sizeof(hints));    hints.ai_family = AF_UNSPEC;    hints.ai_socktype = SOCK_DGRAM;    hints.ai_flags = 0;              // 不设置 AI_PASSIVE → 主动模式    // 2. 解析地址    s = getaddrinfo(argv[1], argv[2], &hints, &result);    if (s != 0) {        fprintf(stderr, "getaddrinfo: %s\n", gai_strerror(s));        exit(EXIT_FAILURE);    }    // 3. 遍历地址链表，尝试创建套接字并连接    for (rp = result; rp != NULL; rp = rp->ai_next) {        sfd = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol);        if (sfd == -1)            continue;        if (connect(sfd, rp->ai_addr, rp->ai_addrlen) != -1)            break;  // 连接成功        close(sfd);    }    freeaddrinfo(result);    if (rp == NULL) {        fprintf(stderr, "Could not connect\n");        exit(EXIT_FAILURE);    }    // 4. 收发数据（省略）    // ...}

💡 关于 UDP 的 connect()：UDP 的 connect() 并不会像 TCP 那样建立真正的连接，而是固定了对端的地址。之后可以用 read()/write() 收发数据，内核会自动使用这个固定地址，同时过滤掉来自其他地址的报文。

有了getaddrinfo()解析出的地址，就能创建套接字进行通信了。下一篇我们将深入 Socket API 的实战，从bind()， listen()到 accept() 和 connect()，并用 TCP Echo 服务器完整走一遍流程。更重要的是，我们会揭示这些 API 调用背后与 TCP 三次握手的对应关系。