Windows下getaddrinfo指定AF_UNSPEC为何仅返回IPv6地址？

核心原因及排查方向 #

1. 系统地址选择优先级影响 #

Windows默认赋予IPv6更高的地址选择优先级（执行netsh interface ipv6 show prefixpolicies可查看，IPv6前缀优先级默认40，IPv4为30）。当使用AF_UNSPEC时，getaddrinfo默认仅返回系统优先选择的地址族结果，而非全部匹配条目。

2. getaddrinfo调用缺少关键标志 #

默认调用逻辑下，AF_UNSPEC不会强制返回所有地址族的匹配结果。需在hints.ai_flags中添加AI_ALL标志，强制枚举所有符合条件的IPv4和IPv6地址；搭配AI_ADDRCONFIG可确保仅返回系统已配置的地址族结果，避免无效条目。

修改后的hints配置示例：

struct addrinfo hints = {0};
hints.ai_family = AF_UNSPEC;
hints.ai_socktype = SOCK_STREAM; // 根据业务需求调整套接字类型
hints.ai_flags = AI_ALL | AI_ADDRCONFIG;

3. mDNS解析接口行为差异 #

Resolve-DnsName是直接查询DNS记录（含mDNS的A/AAAA记录），而getaddrinfo会结合系统地址选择策略返回结果。若未指定完整的mDNS域名（如device-name.local）或服务类型，mDNS解析可能未完整返回双栈地址，需确保查询目标为设备的完整mDNS标识。

4. 地址遍历逻辑不完整 #

若代码仅处理addrinfo链表的第一个条目（恰好是IPv6），会导致遗漏后续的IPv4地址。需完整遍历整个链表，收集所有返回的地址：

struct addrinfo *result, *rp;
int rc = getaddrinfo("target-device.local", NULL, &hints, &result);
if (rc != 0) {
    // 错误处理逻辑
}

// 遍历所有返回的地址条目
for (rp = result; rp != NULL; rp = rp->ai_next) {
    if (rp->ai_family == AF_INET) {
        // 处理IPv4地址
        struct sockaddr_in *ipv4 = (struct sockaddr_in *)rp->ai_addr;
        // 提取地址逻辑
    } else if (rp->ai_family == AF_INET6) {
        // 处理IPv6地址
        struct sockaddr_in6 *ipv6 = (struct sockaddr_in6 *)rp->ai_addr;
        // 提取地址逻辑
    }
}

freeaddrinfo(result);

结论 #

最常见的问题是未添加AI_ALL标志导致getaddrinfo仅返回系统优先的IPv6地址，或代码未完整遍历地址链表。通过添加AI_ALL标志并确保遍历所有条目，即可同时获取IPv4和IPv6地址。

内容的提问来源于stack exchange，提问作者TheNextman