IPv6环境下Echo客户端与服务端连接失败问题求助

问题现象 #

开发的TCP Echo客户端/服务端程序目标支持IPv4和IPv6双栈，但无法通过IPv6地址建立连接；将ai_family改为AF_INET6后依旧报错：

client: connect: Cannot assign requested address
client: failed to connect

客户端核心代码如下：

char buffer[16];
int return_value;
memset(&hints, 0, sizeof(hints)); // Initialize contents of hints to 0
hints.ai_family = AF_UNSPEC; // Allow both IPv4 and IPv6
hints.ai_socktype = SOCK_STREAM; // Stream socket for TCP

if ((return_value = getaddrinfo(hostname, PORT, &hints, &servinfo)) != 0) {
    fprintf(stderr, "getaddrinfo: %s\n", gai_strerror(return_value));
    return 1;
}

// loop through all the results and connect to the first we can
for(p = servinfo; p != NULL; p = p->ai_next) {
    if ((sockfd = socket(p->ai_family, p->ai_socktype,
        p->ai_protocol)) == -1) {
        perror("client: socket");
        continue;
    }

    if (connect(sockfd, p->ai_addr, p->ai_addrlen) == -1) {
        close(sockfd);
        perror("client: connect");
        continue;
    }

    break;
}

排查方向与解决建议 #

1. 服务端监听配置验证 #

• 确认服务端是否监听了IPv6通配地址::：若服务端仅绑定IPv4的0.0.0.0，IPv6客户端无法建立连接。检查服务端bind逻辑，需确保ai_family设为AF_UNSPEC或AF_INET6，且绑定地址为::。
• 部分系统默认支持双栈兼容（绑定::时同时监听IPv4），但需确保服务端未手动禁用该特性。

2. 客户端网络环境检查 #

• 验证客户端主机是否启用IPv6：执行ip addr或ifconfig查看是否存在有效IPv6地址（公网地址以2001:开头，链路本地地址以fe80:开头）。若主机未配置IPv6，代码逻辑再正确也无法连接。
• 若使用链路本地地址，连接时必须携带范围ID（如fe80::1%eth0），否则系统无法确定使用的网络接口，会触发"Cannot assign requested address"错误。

3. 客户端代码细节修正 #

• 确认hostname传入的IPv6地址格式正确：需用方括号包裹（如[2001:db8::1]），避免端口号与地址混淆。直接传入无方括号的IPv6地址可能导致getaddrinfo解析错误。
• 循环结束后需检查p是否为NULL，避免后续操作使用无效的sockfd，补充代码如下：

if (p == NULL) {
    fprintf(stderr, "client: failed to connect\n");
    return 2;
}

4. 系统参数与防火墙排查 #

• 检查Linux系统IPv6启用状态：查看/etc/sysctl.conf中net.ipv6.conf.all.disable_ipv6参数，若值为1则改为0并执行sysctl -p生效。
• 验证IPv6防火墙规则：执行ip6tables -L查看是否允许目标端口的TCP流量，若存在拦截规则需调整。

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