LIBSSH2 C++双栈适配时IPv6连接成功但SSH会话启动失败问题

你代码中IPv6逻辑存在多个错误，直接导致地址构造非法，最终SSH握手失败： #

核心错误点 #

• 误用IPv4地址解析函数处理IPv6地址
  inet_addr()仅支持解析IPv4点分十进制格式的地址，传入IPv6字符串会返回INADDR_NONE（即0xffffffff），属于非法值。且你定义的hostaddr6为uint32_t类型，仅能存储4字节数据，完全无法容纳128位的IPv6地址，存在严重的类型不匹配问题。
• IPv6地址赋值不完整
  你在IPv6分支中仅拷贝了4字节的非法hostaddr6到sinV6.sin6_addr.s6_addr32，仅覆盖了IPv6地址的前32位，剩余96位全部为0，最终构造的目标地址与你实际要连接的地址完全不符。
• 冗余无效代码
  IPv6分支中sin.sin_family = AF_INET6;是无效代码，sin是IPv4专用的sockaddr_in结构，修改其字段不会对IPv6连接产生任何影响。
• 冗余的地址转换逻辑引入额外风险
  你已经通过getaddrinfo()拿到了完整、可用的sockaddr结构，完全不需要先将二进制地址转成字符串、再将字符串转回二进制地址的冗余操作，多步转换反而大幅提升了出错概率。

修复方案 #

最简单的优化是直接复用getaddrinfo()返回的结果，完全删除冗余的地址转换逻辑，修改后核心代码如下：

// 省略前面getaddrinfo成功后的代码
// 直接使用getaddrinfo返回的地址信息创建socket
sock = socket(sAdrInfo->ai_family, sAdrInfo->ai_socktype, sAdrInfo->ai_protocol);
if (sock < 0) {
    SERVER_ERROR("[SSH] create socket failed: %d\n", errno);
    freeaddrinfo(sAdrInfo);
    return -1;
}
// 手动设置端口，因为getaddrinfo第二个参数传了nullptr
if (sAdrInfo->ai_family == AF_INET) {
    ((struct sockaddr_in*)sAdrInfo->ai_addr)->sin_port = htons(remotePort);
} else if (sAdrInfo->ai_family == AF_INET6) {
    ((struct sockaddr_in6*)sAdrInfo->ai_addr)->sin6_port = htons(remotePort);
}
// 直接用现成的sockaddr结构连接
int resCon = connect(sock, sAdrInfo->ai_addr, sAdrInfo->ai_addrlen);
if (resCon != 0){
    SERVER_ERROR("[SSH] failed to connect with error code: %d!\n", errno);
    freeaddrinfo(sAdrInfo);
    close(sock);
    return -1;
}
// 后续逻辑不变
freeaddrinfo(sAdrInfo);

如果要保留你原有逻辑，需要修改IPv6分支的地址赋值代码，直接拷贝getaddrinfo返回的二进制地址：

else if (sAdrInfo->ai_family == AF_INET6) {
    // 去掉inet_addr的错误调用，直接拷贝完整的IPv6地址
    sock = socket(AF_INET6, SOCK_STREAM, 0);
    sinV6.sin6_family = AF_INET6;
    sinV6.sin6_port = htons(remotePort);
    // 直接复制完整的128位IPv6地址
    memcpy(&sinV6.sin6_addr, ptr, sizeof(struct in6_addr));
    // 如有链路本地地址，还需要赋值sin6_scope_id
    sinV6.sin6_scope_id = ((struct sockaddr_in6 *)sAdrInfo->ai_addr)->sin6_scope_id;
}

其他注意事项 #

如果你的服务需要兼容链路本地IPv6地址（以fe80:开头的地址），必须正确设置sockaddr_in6的sin6_scope_id字段，否则会出现连接失败的问题。
部分系统默认关闭IPv6 socket的IPV6_V6ONLY选项，如果不需要兼容IPv4映射的IPv6地址，建议创建IPv6 socket后手动设置该选项为1，避免出现不可预期的行为。

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