C / C++ / 系统课时
配置非阻塞 TCP Socket
配置非阻塞 TCP Socket
这一节把监听端从“能创建”推进到“可用于事件驱动”:完成 socket、bind、listen 和非阻塞设置,并用返回值与 errno 判断成功、可重试和真正失败。最终你会得到一个只监听本机随机端口的非阻塞 TCP 监听 Socket。
学习目标
- 正确创建、绑定并监听一个非阻塞 TCP Socket
- 区分系统调用的成功、可重试与不可恢复失败
- 用程序验证
O_NONBLOCK已经生效
从文件描述符到监听状态
TCP 服务端的最小准备链路是:创建 Socket,绑定本地地址,再进入监听状态。非阻塞并不会改变 bind 和 listen 的基本语义,它主要影响之后的 accept、read、write 等可能等待数据的调用。

Linux 可以在创建 Socket 时直接加入 SOCK_NONBLOCK,这样从一开始就不会出现“先创建阻塞 Socket,再补一次 fcntl”的短暂窗口。SOCK_CLOEXEC 也适合同时设置,避免进程执行其他程序时意外继承该文件描述符。
完成创建、绑定与监听
下面的完整示例只绑定 127.0.0.1,端口填写 0,让内核自动选择空闲端口,适合本地练习时避免固定端口冲突。
#include <arpa/inet.h>
#include <fcntl.h>
#include <netinet/in.h>
#include <sys/socket.h>
#include <unistd.h>
#include <cerrno>
#include <cstring>
#include <iostream>
int main() {
int listen_fd = ::socket(AF_INET, SOCK_STREAM | SOCK_NONBLOCK | SOCK_CLOEXEC, 0);
if (listen_fd == -1) {
std::cerr << "socket failed: " << std::strerror(errno) << '\\n';
return 1;
}
int reuse = 1;
if (::setsockopt(listen_fd, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse)) == -1) {
std::cerr << "setsockopt failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
sockaddr_in addr{};
addr.sin_family = AF_INET;
addr.sin_port = htons(0);
if (::inet_pton(AF_INET, "127.0.0.1", &addr.sin_addr) != 1) {
std::cerr << "inet_pton failed\\n";
::close(listen_fd);
return 1;
}
if (::bind(listen_fd, reinterpret_cast<sockaddr*>(&addr), sizeof(addr)) == -1) {
std::cerr << "bind failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
if (::listen(listen_fd, SOMAXCONN) == -1) {
std::cerr << "listen failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
int flags = ::fcntl(listen_fd, F_GETFL, 0);
if (flags == -1) {
std::cerr << "fcntl failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
sockaddr_in actual{};
socklen_t actual_len = sizeof(actual);
if (::getsockname(listen_fd, reinterpret_cast<sockaddr*>(&actual), &actual_len) == -1) {
std::cerr << "getsockname failed: " << std::strerror(errno) << '\\n';
::close(listen_fd);
return 1;
}
std::cout << "listen_fd=" << listen_fd << '\\n';
std::cout << "port=" << ntohs(actual.sin_port) << '\\n';
std::cout << "nonblocking=" << ((flags & O_NONBLOCK) ? "yes" : "no") << '\\n';
::close(listen_fd);
return 0;
}预期结果:程序成功建立监听 Socket,并确认文件状态标志中包含 O_NONBLOCK。
listen_fd=<ID>
port=<PORT>
nonblocking=yes<ID> 和 <PORT> 由当前进程与内核分配,实际值每次运行都可能不同。关键验收点是最后一行为 nonblocking=yes,且没有打印失败信息。
编译并运行:
g++ -std=c++20 -Wall -Wextra -pedantic nonblocking_listener.cpp -o nonblocking_listener && ./nonblocking_listener预期输出:
listen_fd=<ID>
port=<PORT>
nonblocking=yes读懂成功、重试与失败
socket 成功时返回非负文件描述符,失败返回 -1。bind 和 listen 成功返回 0,失败返回 -1。只有调用明确报告失败之后,才应该读取 errno 判断原因。
进入非阻塞 I/O 后,最容易误判的是 EAGAIN 或 EWOULDBLOCK。它们表达的是“当前条件还不满足,稍后可以再试”,而不是连接损坏。例如非阻塞监听 Socket 暂时没有新连接时,accept 可以立即返回 -1,并将 errno 设置为这两个值之一。
EINTR 表示系统调用被信号打断,通常可以重新执行。相反,EBADF、EINVAL 等错误更可能说明文件描述符无效、参数错误或状态不合法,应修复根因,而不是无限重试。
非阻塞到底改变了什么
给 Socket 设置 O_NONBLOCK,并不意味着 bind、listen 从此拥有一套特殊返回协议。这两个调用仍然完成立即可判定的状态变更。真正发生变化的是那些原本可能等待条件成立的操作,例如等待新连接、等待数据到达或等待发送缓冲区出现空间。
因此,非阻塞网络编程的关键不是“调用永远成功”,而是程序能够把“暂时做不了”与“真正出错”分开。后续 Reactor 事件循环正是根据这种语义,在文件描述符再次可读或可写时重新执行对应操作。