一、函数定位与核心价值

在IPv4向IPv6过渡的进程中，传统网络地址解析函数如gethostbyname()暴露出三大缺陷：仅支持IPv4、返回结构单一、无法处理服务名到端口的映射。POSIX标准引入的getaddrinfo()函数通过统一接口解决了这些问题，其核心价值体现在：

协议无关性：自动适配IPv4/IPv6环境，开发者无需修改代码即可支持双栈网络
结构化输出：返回链式sockaddr结构体，直接用于socket绑定/连接
服务名解析：支持”http”、”ftp”等标准服务名到端口号的自动转换
错误诊断：通过标准错误码提供详细错误信息

该函数已成为现代网络编程的基础组件，在Linux/Unix系统及Windows Socket 2.0+环境中均有实现。

二、函数原型与参数解析

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  // 返回的地址链表
);

2.2 参数详解

节点参数(node)

支持三种格式：
- 主机名："example.com"
- IPv4地址："192.0.2.1"
- IPv6地址："2001:1"
当设置为NULL时，结合AI_PASSIVE标志表示绑定通配地址

服务参数(service)

端口号表示："80"
服务名表示："http"（需在/etc/services中定义）
设置为NULL时，仅解析主机地址

提示参数(hints)

通过struct addrinfo结构体指定解析偏好：

struct addrinfo {
    int      ai_flags;     // 控制标志
    int      ai_family;    // 地址族：AF_UNSPEC(默认), AF_INET, AF_INET6
    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_flags)

标志位	作用
AI_PASSIVE	服务器端使用，生成适合bind()的通配地址
AI_CANONNAME	返回规范主机名到ai_canonname字段
AI_NUMERICHOST	禁止DNS查询，node参数必须为数字地址
AI_NUMERICSERV	禁止服务名解析，service参数必须为端口号
AI_V4MAPPED	当无IPv6地址时，返回IPv4映射的IPv6地址
AI_ALL	与AI_V4MAPPED配合使用，返回所有匹配地址

三、典型应用场景

3.1 客户端地址解析

struct addrinfo hints, *res;
memset(&hints, 0, sizeof hints);
hints.ai_family = AF_UNSPEC;    // 支持IPv4/IPv6
hints.ai_socktype = SOCK_STREAM; // TCP套接字
int status = getaddrinfo("example.com", "http", &hints, &res);
if (status != 0) {
    fprintf(stderr, "getaddrinfo error: %s\n", gai_strerror(status));
    exit(1);
}
// 遍历结果链表
for (struct addrinfo *p = res; p != NULL; p = p->ai_next) {
    void *addr;
    char ipstr[INET6_ADDRSTRLEN];
    if (p->ai_family == AF_INET) { // IPv4
        struct sockaddr_in *ipv4 = (struct sockaddr_in *)p->ai_addr;
        addr = &(ipv4->sin_addr);
    } else { // IPv6
        struct sockaddr_in6 *ipv6 = (struct sockaddr_in6 *)p->ai_addr;
        addr = &(ipv6->sin6_addr);
    }
    inet_ntop(p->ai_family, addr, ipstr, sizeof ipstr);
    printf("IP Address: %s\n", ipstr);
}
freeaddrinfo(res); // 释放链表内存

3.2 服务器端地址准备

struct addrinfo hints, *res;
memset(&hints, 0, sizeof hints);
hints.ai_family = AF_UNSPEC;
hints.ai_socktype = SOCK_STREAM;
hints.ai_flags = AI_PASSIVE; // 关键标志：绑定通配地址
int status = getaddrinfo(NULL, "8080", &hints, &res);
// 后续处理同客户端示例...

3.3 错误处理最佳实践

错误码转换：使用gai_strerror()将错误码转换为可读字符串
资源释放：必须调用freeaddrinfo()释放返回的链表
常见错误码：
- EAI_AGAIN：临时DNS解析失败
- EAI_NONAME：节点名或服务名不存在
- EAI_NODATA：无有效地址记录
- EAI_FAMILY：不支持的地址族

四、性能优化建议

缓存解析结果：对频繁访问的域名建立本地缓存
限制地址族：明确指定AF_INET或AF_INET6可减少解析时间
并行解析：对多个域名使用多线程并行解析
重用hints结构：多次调用时复用已初始化的hints结构

五、与旧函数对比

特性	getaddrinfo()	gethostbyname()	getservbyname()
协议支持	IPv4/IPv6	仅IPv4	仅IPv4
输出结构	链式sockaddr	固定hostent结构	固定servent结构
服务名解析	支持	不支持	仅支持端口号查询
线程安全	是	否	否
错误处理	标准错误码	h_errno	h_errno

六、未来演进方向

随着IPv6的全面普及，getaddrinfo()将进一步强化以下特性：

Happy Eyeballs算法支持：自动选择最优连接路径
DNSSEC验证集成：增强解析结果的安全性
更细粒度的地址选择：支持基于延迟、带宽的地址排序

该函数作为网络地址解析的标准接口，其设计思想对现代网络协议栈开发具有重要参考价值。开发者通过合理使用该函数，可以显著提升网络应用的健壮性和跨平台兼容性。

统一网络地址解析：getaddrinfo函数详解与应用实践