IPv6连接报错WSAEAFNOSUPPORT，双栈客户端技术求助

嘿，我来帮你排查这个困扰你的IPv6连接错误！WSAEAFNOSUPPORT这个错误码核心意思是地址族不被支持/不匹配，咱们从几个最常见的点入手排查：

1. 先检查套接字创建是否对应IPv6地址族 #

你已经替换了地址结构，但如果创建套接字时还是用AF_INET（IPv4），那后续连接IPv6地址肯定会报错！必须确保创建套接字的代码是：

SOCKET sock = socket(AF_INET6, SOCK_STREAM, IPPROTO_TCP);

创建后记得检查返回值，如果是INVALID_SOCKET，立刻用WSAGetLastError()看具体错误。

2. 确认SOCKADDR_IN6结构的填充完全正确 #

这个是高频出错点，很多人会漏填关键字段：

• 必须设置sin6_family = AF_INET6：这是告诉系统这个地址是IPv6类型，没填的话系统会识别成无效地址族
• 端口号要转字节序：用htons()把主机字节序的端口转换成网络字节序，比如serverAddr.sin6_port = htons(80);
• 如果是域名解析来的地址：确保用getaddrinfo()时传入的hints.ai_family = AF_INET6，只获取IPv6的解析结果；遍历解析列表时也要筛选ai_family == AF_INET6的条目，别把IPv4的地址塞到IPv6结构里

3. 升级Winsock版本到支持IPv6的稳定版 #

你当前用的是MAKEWORD(2, 0)（Winsock 2.0），虽然它已经支持IPv6，但部分IPv6相关的函数兼容性不如更高版本。建议改成：

int result = WSAStartup(MAKEWORD(2, 2), &WSAData);
if (result != 0) {
    printf("WSAStartup failed: %d\n", result);
    return 1;
}

Winsock 2.2对IPv6的支持更完善，能避免一些隐性的兼容性问题。

4. 验证系统和网络环境的IPv6支持 #

• 检查本地系统是否启用了IPv6：Windows下可以打开网络适配器属性，确认“Internet协议版本6 (TCP/IPv6)”是勾选状态
• 确认目标服务器确实提供IPv6服务：用ping6 目标域名/IPv6地址测试连通性，如果ping不通，那连接失败可能是网络问题而非代码问题
• 确认域名有AAAA记录：IPv6对应的域名解析记录是AAAA，如果你的域名只有A记录（IPv4），那解析出来的地址还是IPv4，强行用IPv6结构连接自然会报错

修正后的示例代码片段 #

这里给你一个完整的IPv6客户端连接示例，你可以对照自己的代码找差异：

#include <winsock2.h>
#include <ws2tcpip.h>
#include <stdio.h>
#pragma comment(lib, "ws2_32.lib")

int main() {
    printf("Simple_Client IPv4 & IPv6\n\n");

    // 初始化Winsock 2.2版本
    WSADATA WSAData;
    int result = WSAStartup(MAKEWORD(2, 2), &WSAData);
    if (result != 0) {
        printf("WSAStartup failed: %d\n", result);
        return 1;
    }

    // 创建IPv6流式套接字
    SOCKET sock = socket(AF_INET6, SOCK_STREAM, IPPROTO_TCP);
    if (sock == INVALID_SOCKET) {
        printf("socket creation failed: %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    // 准备域名解析的hints，只获取IPv6地址
    struct addrinfo hints, *addrList, *p;
    memset(&hints, 0, sizeof(hints));
    hints.ai_family = AF_INET6;
    hints.ai_socktype = SOCK_STREAM;
    hints.ai_protocol = IPPROTO_TCP;

    // 解析目标域名
    result = getaddrinfo("example.com", "80", &hints, &addrList);
    if (result != 0) {
        printf("getaddrinfo failed: %d\n", result);
        closesocket(sock);
        WSACleanup();
        return 1;
    }

    // 遍历解析结果，尝试连接
    for (p = addrList; p != NULL; p = p->ai_next) {
        result = connect(sock, p->ai_addr, (int)p->ai_addrlen);
        if (result == 0) {
            printf("Connected to IPv6 server successfully!\n");
            break;
        } else {
            printf("connect attempt failed: %d\n", WSAGetLastError());
        }
    }

    // 释放解析资源
    freeaddrinfo(addrList);

    // 后续的发送/接收操作...

    // 清理资源
    closesocket(sock);
    WSACleanup();
    return 0;
}

先从这几个点排查，大概率能解决你的问题！

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