一、网络地址解析的演进与挑战

在TCP/IP网络编程中，主机名到IP地址的转换（DNS解析）和服务名到端口号的映射是基础操作。早期系统通过gethostbyname()和getservbyname()分别处理主机名和服务名解析，但存在三大缺陷：

协议隔离：仅支持IPv4，无法适配IPv6网络环境
数据结构割裂：返回的hostent和servent结构需要手动拼接成套接字地址
错误处理粗糙：缺乏统一的错误码体系，调试困难

随着IPv6的普及，POSIX标准引入getaddrinfo()函数，通过统一接口实现：

双栈协议支持（IPv4/IPv6）
结构化地址链表输出
精细化的控制参数
完善的错误反馈机制

该函数已成为现代网络编程中地址解析的标准方案，被Linux/Unix系统及Windows Socket API广泛支持。

二、函数原型与核心数据结构

2.1 函数签名解析

#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>
int getaddrinfo(
    const char *node,      // 主机名或IP地址字符串
    const char *service,   // 服务名或端口号字符串
    const struct addrinfo *hints, // 解析参数提示
    struct addrinfo **res  // 输出参数：地址链表头指针
);

返回值说明：

成功时返回0，失败返回非0错误码（通过gai_strerror()转换为可读字符串）
典型错误码：EAI_AGAIN（临时失败）、EAI_NONAME（域名不存在）、EAI_NODATA（无有效地址）

2.2 addrinfo结构体详解

struct addrinfo {
    int              ai_flags;     // 控制标志位
    int              ai_family;    // 地址族：AF_INET/AF_INET6/AF_UNSPEC
    int              ai_socktype;  // 套接字类型：SOCK_STREAM/SOCK_DGRAM
    int              ai_protocol;  // 协议类型：IPPROTO_TCP/IPPROTO_UDP
    socklen_t        ai_addrlen;   // 套接字地址长度
    struct sockaddr *ai_addr;      // 指向套接字地址的指针
    char            *ai_canonname; // 规范主机名（如果请求）
    struct addrinfo *ai_next;      // 链表下一个节点
};

该结构通过链表组织多个地址结果，每个节点包含完整的套接字地址信息，开发者可直接用于connect()或bind()等操作。

三、参数配置与使用模式

3.1 hints参数的精准控制

通过填充addrinfo结构体（通常只需设置部分字段）指导解析行为：

struct addrinfo hints = {0};
hints.ai_family = AF_UNSPEC;    // 优先返回IPv6地址（若可用）
hints.ai_socktype = SOCK_STREAM; // 指定TCP套接字
hints.ai_flags = AI_PASSIVE;    // 服务器端绑定通配地址

关键标志位组合：

标志位	适用场景	行为说明
`AI_PASSIVE`	服务器端`bind()`	node参数为NULL时生成通配地址
`AI_CANONNAME`	需要获取规范主机名	填充ai_canonname字段
`AI_NUMERICHOST`	禁用DNS查询	node必须为IP地址字符串
`AI_NUMERICSERV`	禁用服务名解析	service必须为端口号字符串

3.2 典型使用流程

struct addrinfo *res, *p;
int ret;
struct addrinfo hints = {0};
hints.ai_family = AF_UNSPEC;
hints.ai_socktype = SOCK_STREAM;
// 解析域名"example.com"的80端口
if ((ret = getaddrinfo("example.com", "80", &hints, &res)) != 0) {
    fprintf(stderr, "解析失败: %s\n", gai_strerror(ret));
    exit(1);
}
// 遍历结果链表
for (p = res; p != NULL; p = p->ai_next) {
    // 根据地址族创建套接字
    int sockfd = socket(p->ai_family, p->ai_socktype, p->ai_protocol);
    if (sockfd == -1) continue;
    // 客户端连接或服务器绑定
    if (connect(sockfd, p->ai_addr, p->ai_addrlen) == 0) {
        // 连接成功处理
        break;
    }
    close(sockfd);
}
// 释放资源
freeaddrinfo(res);

四、IPv6过渡期的最佳实践

4.1 双栈支持实现

通过设置ai_family = AF_UNSPEC，函数会优先返回IPv6地址（若客户端支持），实现透明过渡：

hints.ai_family = AF_UNSPEC; // 自动选择最优协议版本

4.2 服务器端配置示例

// 创建监听所有接口的TCP套接字
struct addrinfo hints = {
    .ai_flags = AI_PASSIVE,
    .ai_family = AF_UNSPEC,
    .ai_socktype = SOCK_STREAM
};
struct addrinfo *res;
getaddrinfo(NULL, "8080", &hints, &res); // node为NULL表示通配地址
// 遍历结果绑定首个可用地址
for (struct addrinfo *p = res; p != NULL; p = p->ai_next) {
    int fd = socket(p->ai_family, p->ai_socktype, p->ai_protocol);
    if (fd < 0) continue;
    if (bind(fd, p->ai_addr, p->ai_addrlen) == 0) {
        listen(fd, SOMAXCONN);
        break;
    }
    close(fd);
}
freeaddrinfo(res);

五、与传统函数的对比优势

特性	getaddrinfo	gethostbyname/getservbyname
协议支持	IPv4/IPv6双栈	仅IPv4
输出结构	完整sockaddr链表	分散的hostent/servent结构
线程安全	是（无静态缓冲区）	否（使用全局缓冲区）
错误处理	精细错误码体系	简单h_errno机制
扩展性	支持套接字类型/协议过滤	仅基本解析功能

六、性能优化建议

缓存解析结果：对频繁访问的域名实施本地缓存（注意TTL失效）
异步解析：结合getaddrinfo_a()（GNU扩展）实现非阻塞解析
限制结果数量：通过ai_flags控制返回地址类型，减少不必要的解析
错误重试机制：对EAI_AGAIN等临时错误实施指数退避重试

七、常见问题排查

解析失败：检查/etc/hosts和DNS配置，使用dig/nslookup验证域名
地址选择异常：确认系统IPv6支持状态（cat /proc/sys/net/ipv6/conf/all/disable_ipv6）
内存泄漏：确保每次调用后都调用freeaddrinfo()释放链表
协议不匹配：检查ai_family与后续套接字操作的一致性

通过掌握getaddrinfo的完整使用范式，开发者能够构建出兼容性强、性能优异的网络应用程序，轻松应对IPv4到IPv6的过渡挑战。该函数的设计哲学——通过抽象化协议细节实现上层透明访问——正是现代网络编程接口演进的重要方向。

getaddrinfo函数详解：从基础到实践的网络地址解析方案