C++如何通过域名解析获取对应IP地址（getaddrinfo）-C++-PHP中文网

getaddrinfo更推荐，因其是posix标准现代接口，支持ipv4/ipv6双栈、线程安全、可指定协议族与套接字类型；而gethostbyname已废弃，仅支持ipv4、非线程安全且无法定制解析行为。

c++如何通过域名解析获取对应ip地址（getaddrinfo）

getaddrinfo 为什么比 gethostbyname 更推荐

因为 gethostbyname 已废弃，不支持 IPv6、线程不安全、无法指定协议族或 socket 类型。而 getaddrinfo 是 POSIX 标准的现代接口，能同时处理 IPv4/IPv6、TCP/UDP、阻塞/非阻塞场景，且返回结构体链表可直接用于 socket + connect 或 bind。

常见错误是传错 hints.ai_family：设成 AF_INET 就只能查 IPv4，设成 AF_UNSPEC 才可能返回双栈结果；另外漏设 hints.ai_socktype 或 hints.ai_protocol 可能导致返回多个冗余条目（比如同一个 IP 返回 TCP 和 UDP 两套地址）。

实操建议：

始终初始化 hints 结构体为零：struct addrinfo hints = {};
至少设置 hints.ai_family = AF_UNSPEC 和 hints.ai_socktype = SOCK_STREAM（如需 TCP）
调用后必须用 freeaddrinfo 释放内存，否则内存泄漏
检查返回值是否为 0，非 0 时用 gai_strerror 打印错误，例如 EAI_NONAME 表示域名不存在，EAI_AGAIN 表示 DNS 查询超时

如何正确解析域名并提取第一个可用 IPv4 或 IPv6 地址

多数场景只需一个可用地址（比如建立连接），不需要遍历整个 addrinfo 链表。关键点在于：不能假设第一个节点就是 IPv4，也不能硬编码取 sin_addr 字段——IPv6 节点对应的是 sin6_addr。

实操建议：

遍历 result 链表，用 ai->ai_family == AF_INET 或 ai->ai_family == AF_INET6 判断类型
用 getnameinfo 安全提取 IP 字符串（自动适配 v4/v6），避免手动强转 sockaddr_in* 导致越界
若只要 IPv4，可在 hints.ai_family = AF_INET；但注意某些内网环境（如 Kubernetes）可能只配置了 AAAA 记录，强制限定反而失败

示例中提取首个 IPv4 地址的逻辑：

for (auto* ai = result; ai; ai = ai->ai_next) {
    if (ai->ai_family == AF_INET) {
        auto* sin = (sockaddr_in*)ai->ai_addr;
        char ip[INET_ADDRSTRLEN];
        if (inet_ntop(AF_INET, &sin->sin_addr, ip, sizeof(ip))) {
            printf("IPv4: %s\n", ip);
            break;
        }
    }
}

getaddrinfo 在 Windows 上的兼容性注意事项

Windows 下必须先调用 WSAStartup 初始化 Winsock，否则 getaddrinfo 直接返回 WSANOTINITIALISED（对应错误码 10093）。这个错误不触发 gai_strerror，容易误判为域名问题。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

另一个坑是：MinGW 或较老的 MSVC 版本可能没有完整实现 getaddrinfo 的 IPv6 支持，尤其在 ai_flags 使用 AI_ADDRCONFIG 时行为异常——它本意是“只返回本地网络支持的地址族”，但在某些 Windows 版本会过滤掉本应存在的 IPv6 地址。

实操建议：