为何我的简易HTTP服务器需运行两个实例才能正常工作？

问题描述 #

我是网络编程新手，正在学习《Beej网络编程指南》，并参照书中代码风格在FreeBSD 14.0系统上构建HTTP服务器。遇到的问题是：所有服务器程序都必须同时运行两个实例才能成功建立连接——即通过./httpserver & ./httpserver或类似方式启动两次；仅运行一个实例时连接会被拒绝。

我还尝试过使用select()函数的实现，但存在完全相同的问题（需两个实例才能工作）。

以下是我编写的简易并发HTTP服务器代码：

// include statements omitted 

int main(void) {
    int sockfd;
    int rv;
    int yes = 1;
    struct addrinfo hints, *res, *p;

    memset(&hints, 0, sizeof(hints));
    hints.ai_family = AF_UNSPEC;
    hints.ai_socktype = SOCK_STREAM;
    hints.ai_flags = AI_PASSIVE;
    if ((rv = getaddrinfo(NULL, "8000", &hints, &res)) != 0) {
        fprintf(stderr, "httpserver: %s\n", gai_strerror(rv));
        exit(1);
    }

    for (p = res; p != NULL; p = p->ai_next) {
        sockfd = socket(p->ai_family, p->ai_socktype, p->ai_protocol);
        if (sockfd < 0) {
            continue;
        }

        setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &yes, sizeof(int));

        if (bind(sockfd, p->ai_addr, p->ai_addrlen) < 0) {
            close(sockfd);
            continue;
        }

        break;
    }

    if (p == NULL) {
        fprintf(stderr, "httpserver: could not bind to any address\n");
        freeaddrinfo(res);
        exit(1);
    }
    freeaddrinfo(res);

    if (listen(sockfd, 10) == -1) {
        perror("listen");
        exit(1);
    }

    // main loop. 
    while (1) {
        int newfd;
        struct sockaddr_storage theiraddr;
        socklen_t addrlen;

        addrlen = sizeof(theiraddr);
        newfd = accept(sockfd, (struct sockaddr*)&theiraddr, &addrlen);

        if (newfd == -1) {
            perror("accept");
            continue;
        }

        if (!fork()) { // Child process
            close(sockfd); // Child doesn't need the listener
            char buf[4096];
            int nbytes = recv(newfd, buf, sizeof(buf), 0);
            if (nbytes > 0) {
                buf[nbytes] = '\0';
                printf("Received request: %s\n", buf);

                // Simple HTTP response
                const char *response =
                    "HTTP/1.1 200 OK\r\n"
                    "Content-Type: text/html\r\n"
                    "Content-Length: 70\r\n"
                    "\r\n"
                    "<html><head><title>Test</title></head><body><h1>Hello, World!</h1></body></html>";
                if (send(newfd, response, strlen(response), 0) == -1) {
                    perror("send");
                }
            } else if (nbytes == 0) {
                printf("server: socket %d hung up\n", newfd);
            } else {
                perror("recv");
            }
            close(newfd);
            exit(0); // Exit child process after handling connection
        }

        // Parent process
        close(newfd); // Parent doesn't need this socket
    }

    close(sockfd);
    return 0;
}

原因分析与解决方案 #

核心原因：IPv6/IPv4双栈兼容性限制 #

FreeBSD默认启用IPV6_V6ONLY选项，即IPv6套接字仅处理IPv6连接，不会兼容IPv4请求。你的代码使用AF_UNSPEC作为地址族，getaddrinfo会优先返回IPv6地址条目（如::），第一个实例绑定该地址后，只能监听IPv6连接。如果你的客户端通过IPv4地址（如127.0.0.1）发起请求，会因没有套接字监听IPv4的0.0.0.0:8000而被拒绝。

当启动第二个实例时，IPv6地址已被绑定，循环会走到下一个IPv4地址条目，绑定并监听0.0.0.0:8000，此时IPv4请求能被处理，看起来像是需要两个实例才能工作。

验证方式 #

启动单个实例后，执行netstat -an | grep 8000，若输出仅包含:::8000（IPv6监听），无0.0.0.0:8000（IPv4监听），即可确认是该问题。此外，尝试用IPv6地址连接（如curl http://[::1]:8000），单个实例应能正常响应。

解决方案 #

1. 开启IPv6套接字的IPv4兼容模式
   在创建套接字后、绑定前，添加IPV6_V6ONLY选项设置，让同一个套接字同时处理IPv6和IPv4连接：

   int v6only = 0;
   setsockopt(sockfd, IPPROTO_IPV6, IPV6_V6ONLY, &v6only, sizeof(v6only));
   

   将这段代码放在setsockopt(SO_REUSEADDR)之后、bind()之前即可。

2. 强制使用IPv4地址族
   修改hints.ai_family为AF_INET，让程序仅绑定IPv4的0.0.0.0:8000：

   hints.ai_family = AF_INET;
   

3. 绑定所有可用地址
   修改循环逻辑，不要在第一个成功绑定后break，而是为每个地址条目创建套接字并监听，让单个实例同时监听IPv6和IPv4地址：

   // 移除原循环中的break，改为保存所有成功绑定的套接字
   int listen_sockets[10];
   int count = 0;
   for (p = res; p != NULL && count < 10; p = p->ai_next) {
       int fd = socket(p->ai_family, p->ai_socktype, p->ai_protocol);
       if (fd < 0) continue;
   
       setsockopt(fd, SOL_SOCKET, SO_REUSEADDR, &yes, sizeof(int));
       // 可选：添加IPV6_V6ONLY设置
   
       if (bind(fd, p->ai_addr, p->ai_addrlen) < 0) {
           close(fd);
           continue;
       }
       if (listen(fd, 10) == -1) {
           close(fd);
           continue;
       }
       listen_sockets[count++] = fd;
   }
   // 后续需要用select/poll等管理多个监听套接字
   

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