为什么 TCP 服务端重启会出现 “Address already in use”问题解析

为什么 TCP 服务端重启会出现 "Address already in use"？

------ TIME_WAIT 与 SO_REUSEADDR 全解析（简洁版）

在网络编程中，很多人写 TCP 服务端时都会遇到一个常见问题：服务端关闭后马上重启，会出现如下错误：

复制代码

bind failed: Address already in use

直观上看，程序已经完全退出，端口应该空闲了，为什么系统还说"端口被占用"？

要理解这个问题，需要从 TCP 的关闭机制和 TIME_WAIT 状态说起。

一、bind 为什么会失败？

当你调用：

c 复制代码

bind(sockfd, (struct sockaddr*)&addr, sizeof(addr));

操作系统会尝试把指定的 IP 和端口绑定到这个 socket 上。如果系统认为这个端口"仍在使用中"，bind 就会失败。

而这里的"正在使用"，并不一定意味着有程序正在运行，更常见的原因是：

这个端口处于 TCP 的 TIME_WAIT 状态。

二、什么是 TIME_WAIT？

在 TCP 断开连接的过程中，会经历四次挥手：

复制代码

FIN → ACK → FIN → ACK

其中 主动关闭连接的一方 会进入 TIME_WAIT 状态。

TIME_WAIT 会保持一段时间（通常约 30 秒到 2 分钟）。

这段时间内：
端口虽然没有被程序使用，但仍被内核标记为暂不可用。

原因有两个：

防止延迟到达的旧数据包影响新连接
确保对方能正确接收到最后的 ACK

如果没有 TIME_WAIT，TCP 协议就无法保证安全、可靠地断开连接。

三、为什么 TIME_WAIT 会影响重启服务？

假设服务端监听端口 8000。

你第一次运行程序时：

使用 bind 绑定端口 8000
监听并建立 TCP 连接
程序退出，进入四次挥手
服务端作为主动关闭方，进入 TIME_WAIT

此时端口 8000 并没有被应用程序占用，但内核认为：

"这个端口对应的旧连接还没有彻底清理完，暂时不能分配给新的 socket。"

你再启动服务端，bind 同样端口，就会失败：

复制代码

Address already in use

四、如何解决？SO_REUSEADDR 是标准做法

解决方法是，在 bind 之前添加如下代码：

c 复制代码

int opt = 1;
setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));

这一句的作用是：

允许在 TIME_WAIT 状态下复用本地端口，只要不与正在使用的活动连接冲突。

这也是所有服务器程序（Nginx、Redis、MySQL）的标准写法。

五、SO_REUSEADDR 是什么意思？

setsockopt 用来给 socket 设置选项。

c 复制代码

setsockopt(socket, level, option, value, value_len);

此处参数含义：

SOL_SOCKET：设置的是套接字级别的选项
SO_REUSEADDR：允许端口重用
opt = 1：开启这个选项

启用 SO_REUSEADDR 后，即使端口仍处于 TIME_WAIT，bind 也能成功。

六、完整示例（推荐写法）

c 复制代码

int sockfd = socket(AF_INET, SOCK_STREAM, 0);

int opt = 1;
setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));

struct sockaddr_in addr;
addr.sin_family = AF_INET;
addr.sin_port = htons(8000);
addr.sin_addr.s_addr = inet_addr("127.0.0.1");

if (bind(sockfd, (struct sockaddr*)&addr, sizeof(addr)) < 0) {
    perror("bind failed");
    exit(1);
}

listen(sockfd, 5);

只要加了 SO_REUSEADDR，你的服务端就可以随时重启，不再受到 TIME_WAIT 的限制。

七、总结（最核心三句话）

TCP 连接断开后会进入 TIME_WAIT 状态，端口不会立即释放。
服务端关闭后立刻重启通常会因为 TIME_WAIT 导致 bind 失败。
在 bind 前设置 SO_REUSEADDR 可以允许端口快速复用，是标准做法。