双栈网络服务器无法正确处理IPv4请求问题排查

问题现象 #

实现了一个双栈C++服务器（通过设置IPV6_V6ONLY=0让单个IPv6套接字同时处理IPv4和IPv6连接），但无论客户端用IPv4还是IPv6连接，服务器的accept返回的peer_address.ss_family始终是AF_INET6，导致IPv4连接的处理逻辑从未被触发。两类客户端都能正常连接，但服务器始终打印IPv6相关信息。

服务器核心代码片段：

// 创建IPv6套接字并关闭V6ONLY选项
const auto server_fd = socket(AF_INET6, SOCK_STREAM, 0);
int opt = 0;
setsockopt(server_fd, IPPROTO_IPV6, IPV6_V6ONLY, &opt, sizeof(opt));

// ... bind和listen逻辑 ...

// 接受连接并判断协议族
sockaddr_storage peer_address;
socklen_t peer_address_length = sizeof(peer_address);
auto peer_fd = accept(server_fd, reinterpret_cast<sockaddr*>(&peer_address), &peer_address_length);

if(peer_address.ss_family == AF_INET)
{
    // 此分支从未执行
    const auto p_peer_address = &peer_address;
    sockaddr_in* ipv4 = (sockaddr_in*)p_peer_address;
    std::println("Client port (IPv4): {}", ntohs(ipv4->sin_port));
}
else if(peer_address.ss_family == AF_INET6)
{
    // 所有连接都进入此分支
    const auto p_peer_address = &peer_address;
    sockaddr_in6* ipv6 = (sockaddr_in6*)p_peer_address;
    std::println("Client port (IPv6): {}", ntohs(ipv6->sin6_port));
}

问题原因 #

这是IPv4-mapped IPv6地址的正常行为：当双栈服务器关闭IPV6_V6ONLY选项后，操作系统会将所有IPv4连接转换为IPv6格式的映射地址（格式为::ffff:x.x.x.x，其中x.x.x.x是原IPv4地址），此时accept返回的套接字地址结构依然是AF_INET6类型，而非AF_INET。

这种转换是系统层面的机制，目的是让双栈应用可以统一用IPv6的API处理所有连接，无需单独维护IPv4套接字。

解决方案 #

在服务器中，当检测到ss_family为AF_INET6时，需要进一步判断该IPv6地址是否属于IPv4映射地址，如果是，则按IPv4逻辑处理。

修改后的服务器核心判断逻辑如下：

if(peer_address.ss_family == AF_INET6)
{
    sockaddr_in6* ipv6 = reinterpret_cast<sockaddr_in6*>(&peer_address);
    // 判断是否为IPv4映射地址
    if (IN6_IS_ADDR_V4MAPPED(&ipv6->sin6_addr))
    {
        // 将IPv6地址转换为IPv4地址
        sockaddr_in ipv4_addr{};
        std::memset(&ipv4_addr, 0, sizeof(ipv4_addr));
        ipv4_addr.sin_family = AF_INET;
        ipv4_addr.sin_port = ipv6->sin6_port;
        // 提取映射的IPv4部分（从第12字节开始的4个字节）
        std::memcpy(&ipv4_addr.sin_addr.s_addr, &ipv6->sin6_addr.s6_addr[12], 4);
        
        std::println("Client port (IPv4): {}", ntohs(ipv4_addr.sin_port));
        // 打印IPv4地址
        char ipv4_str[INET_ADDRSTRLEN];
        inet_ntop(AF_INET, &ipv4_addr.sin_addr, ipv4_str, INET_ADDRSTRLEN);
        std::println("Client IPv4 address: {}", ipv4_str);
    }
    else
    {
        // 真正的IPv6连接
        std::println("Client port (IPv6): {}", ntohs(ipv6->sin6_port));
        char ipv6_str[INET6_ADDRSTRLEN];
        inet_ntop(AF_INET6, &ipv6->sin6_addr, ipv6_str, INET6_ADDRSTRLEN);
        std::println("Client IPv6 address: {}", ipv6_str);
    }
}
else if(peer_address.ss_family == AF_INET)
{
    // 兼容某些不进行地址转换的系统配置
    sockaddr_in* ipv4 = reinterpret_cast<sockaddr_in*>(&peer_address);
    std::println("Client port (IPv4): {}", ntohs(ipv4->sin_port));
    char ipv4_str[INET_ADDRSTRLEN];
    inet_ntop(AF_INET, &ipv4->sin_addr, ipv4_str, INET_ADDRSTRLEN);
    std::println("Client IPv4 address: {}", ipv4_str);
}
else
{
    throw std::runtime_error("unrecognized ss_family");
}

关键说明 #

• IN6_IS_ADDR_V4MAPPED宏用于判断IPv6地址是否为IPv4映射地址，需包含<netinet/in.h>头文件。
• 转换IPv4地址时，直接从IPv6地址的s6_addr数组第12字节开始复制4个字节，这是IPv4映射地址的固定格式。
• 保留AF_INET分支判断，以兼容部分可能不进行地址转换的系统配置。

额外验证 #

可以在服务器中打印客户端完整地址，确认是否为IPv4映射地址：

char addr_str[INET6_ADDRSTRLEN];
if (peer_address.ss_family == AF_INET6)
{
    sockaddr_in6* ipv6 = reinterpret_cast<sockaddr_in6*>(&peer_address);
    inet_ntop(AF_INET6, &ipv6->sin6_addr, addr_str, INET6_ADDRSTRLEN);
    std::println("Client address: {}", addr_str);
}

如果是IPv4客户端连接，打印的地址会是::ffff:127.0.0.1这类格式。

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