根本原因是TCP连接关闭后进入TIME_WAIT状态,默认持续60秒,内核禁止新套接字复用该四元组;需先用ss确认是TIME_WAIT而非进程占用,再在bind前设置SO_REUSEADDR选项。

Linux服务重启时提示“Address already in use”,明明端口已释放却无法立即绑定,根本原因是TCP连接关闭后进入TIME_WAIT状态,默认持续60秒,内核禁止新套接字复用该四元组(源IP:源端口→目的IP:目的端口),尤其在高频启停或高并发短连接场景下极易卡住部署流程。
确认端口是否真处于TIME_WAIT而非被其他进程占用
先排除干扰项:运行 ss -tan | grep ':【你的端口号】',若输出中出现大量 TIME-WAIT 状态行(如 TIME-WAIT 0 0 127.0.0.1:8080 0.0.0.0:* ),说明是协议栈行为,不是进程残留;若显示 LISTEN 或 ESTABLISHED,则需用 lsof -i :【你的端口号】 查杀真实占用进程。
这一步跳过会直接导致后续设置失效——SO_REUSEADDR对真正被占用的端口完全无效。
在代码中启用SO_REUSEADDR选项
方法一:C语言服务端(最典型)
在调用 bind() 前插入以下三行:
int opt = 1;setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));bind(sockfd, (struct sockaddr*)&addr, sizeof(addr));
注意:【必须在bind之前调用,且不能在connect或listen之后】。否则内核直接忽略该选项,错误静默发生。
方法二:Python(以socketserver为例)
重写 server_bind() 方法:
def server_bind(self): self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) self.socket.bind(self.server_address)
Python默认不启用此选项,不覆盖就会沿用系统默认行为。
验证SO_REUSEADDR是否生效
第一步:启动服务,用 curl http://localhost:【端口】 确认正常响应;
第二步:Ctrl+C终止服务,立刻执行 ss -tan | grep ':【端口】' → 观察是否仍有TIME_WAIT条目;
第三步:**不等待**,立即再次启动同一服务;
若不再报“Address already in use”,说明SO_REUSEADDR已起效。此时即使ss仍显示TIME_WAIT,新bind也能成功——这是内核允许的“有条件复用”。











