绑定::的TCP服务端accept获取IPv4客户端IP为::的问题排查

服务端绑定IPv6地址::试图接收所有连接，核心实现代码如下：

void StartServer(std::string ip, unsigned int port)
{
    union sockaddr_types
    {
        struct sockaddr_storage storage;
        struct sockaddr addr;
        struct sockaddr_in in4;
        struct sockaddr_in6 in6;
    };
    sockaddr_types address_storage = {};
    
    if (inet_pton(PF_INET, ip.c_str(), &address_storage.in4.sin_addr) == 1)
    {
        address_storage.in4.sin_family = AF_INET;
        address_storage.in4.sin_port = htons(port);
    }
    else if (inet_pton(PF_INET6, ip.c_str(), &address_storage.in6.sin6_addr) == 1)
    {
        address_storage.in6.sin6_family = AF_INET6;
        address_storage.in6.sin6_port = htons(port);
    }
    else
    {
         return;
    }
    
    SocketFd = socket(address_storage.addr.sa_family, SOCK_STREAM, 0); // SocketFd为类成员或全局变量
    int opt = 1;
    int ret = 0; 
    if (setsockopt(SocketFd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt)))
    {
        // 错误处理
    }
    else
    {
        if ((ret = bind(SocketFd, &address_storage.addr, sizeof(address_storage))) < 0)
        {
            // 错误处理
        }
        else
        {
            if ((ret = listen(SocketFd, QueueSize)) < 0)
            {
                 // 错误处理               
            }
            else
            {
                while (true) // 简化示例逻辑
                {
                    int clientScoketFd = 0;
                    sockaddr_in clientAddr = {};
                    socklen_t clientAddrlen = sizeof(clientAddr);

                    if ((clientScoketFd = accept(SocketFd, (sockaddr*)&clientAddr, &clientAddrlen)) < 0)
                    {
                         // 错误处理
                    }
                    char buff[255] = {};
                    inet_ntop(clientAddr.sin_family, &clientAddr.sin_addr, buff, sizeof(buff));
                    printf("IP %s\n", buff);
                    DoJobOnSocket(clientScoketFd, buff);
                }
            }
        }
    }
}

当IPv4客户端连接该服务端时，控制台输出为：

IP ::

存在两个疑问：

• 为什么获取到的地址是全零::，而非客户端实际IPv4地址？
• 绑定IPv4地址启动时可以正确识别客户端IPv4地址，双栈场景下是否有方法正确获取IPv4客户端地址，还是必须单独绑定IPv4地址启动服务？

出现全零地址是代码的地址结构体使用错误导致的，和双栈机制本身无关：

1. 绑定::的IPv6 socket默认开启双栈接收能力，IPv4客户端发起的连接会以IPv4映射IPv6地址（格式为::ffff:x.x.x.x）的形式被内核接收，此时内核返回的客户端地址是标准的sockaddr_in6（IPv6地址结构）。
2. 代码中硬编码使用sockaddr_in（IPv4专用地址结构）作为accept的输出缓冲区，两种地址结构内存布局完全不同：sockaddr_in总长度16字节，sockaddr_in6总长度28字节，写入时会出现内存布局错位。
3. 后续调用inet_ntop时，传入的地址族参数实际取到的是sockaddr_in6结构的sin6_family字段（值为AF_INET6），但传入的地址指针指向的内存位置仅对应sockaddr_in6中sin6_addr的前4字节，对于IPv4映射IPv6地址来说，sin6_addr的前80bit全为0，因此最终解析出来的地址就是全零的::。

不需要单独绑定IPv4地址，有两种成熟的实现方案可选：

方案1：保留双栈socket，修复地址接收逻辑 #

将固定的sockaddr_in替换为通用地址结构sockaddr_storage，该结构长度足够容纳所有协议的地址结构，不会出现布局错位问题，修复后的accept段代码如下：

while (true)
{
    int clientSocketFd = 0;
    // 替换为通用地址存储结构
    sockaddr_storage clientAddr = {};
    socklen_t clientAddrlen = sizeof(clientAddr);

    if ((clientSocketFd = accept(SocketFd, (sockaddr*)&clientAddr, &clientAddrlen)) < 0)
    {
        // 错误处理
    }
    char buff[255] = {};
    // 根据实际地址族调用inet_ntop
    if (clientAddr.ss_family == AF_INET) {
        inet_ntop(AF_INET, &((sockaddr_in*)&clientAddr)->sin_addr, buff, sizeof(buff));
    } else if (clientAddr.ss_family == AF_INET6) {
        // 若需要提取纯IPv4地址，可通过IN6_IS_ADDR_V4MAPPED宏判断后取内嵌的IPv4段
        inet_ntop(AF_INET6, &((sockaddr_in6*)&clientAddr)->sin6_addr, buff, sizeof(buff));
    }
    printf("IP %s\n", buff);
    DoJobOnSocket(clientSocketFd, buff);
}

这种写法下，inet_ntop会自动识别IPv4映射IPv6地址，输出格式为::ffff:192.168.1.xxx的正确地址，不会返回全零值。

方案2：关闭双栈，分别绑定IPv4、IPv6 socket #

如果不需要双栈特性、希望IPv4和IPv6连接完全独立处理，可以在创建IPv6 socket后、调用bind前添加如下设置，关闭IPv6 socket的双栈接收能力：

int v6only = 1;
setsockopt(SocketFd, IPPROTO_IPV6, IPV6_V6ONLY, &v6only, sizeof(v6only));

设置后该IPv6 socket仅能接收纯IPv6连接，需要额外创建一个AF_INET类型的socket，绑定0.0.0.0地址单独处理IPv4连接。这种方案跨平台兼容性最好，不同操作系统下的行为完全一致。

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