Python进程结束后端口占用问题解析

听雨眠

发布时间：2026-10-16| 2人浏览过

原创

本文解析Python服务端进程退出后端口仍被占用的原因，主要涉及操作系统处理TIME_WAIT状态连接。通过示例展示使用netstat查看连接状态及重启服务报错，并提供setsockopt设置SO_REUSEADDR的解决方案，同时对比C语言中SO_REUSEADDR与SO_REUSEPORT的差异及客户端使用注意事项。

socket分配

服务端进程向操作系统申请一个 scoket 用于监听。进程退出后，未关闭的连接不会立即消失，而是交由操作系统处理。若操作系统在关闭连接时出现异常，该连接可能长期处于 TIME_WAIT 或其他非正常状态，导致对应端口持续被占用。此时若重新启动服务端程序，会因地址被占用而报错。

例子

测试代码：

import socket
s = socket.socket()
s.bind(('0.0.0.0', 12345))
s.listen()
(client, addr) = s.accept()
print(client)
print(addr)

使用 nc 进行连接：

nc 127.0.0.1 12345

服务端会打印 client 和 addr ，然后正常退出，但是此时使用 netstat -anop | grep 12345 查看，发现对应连接并没有被立即释放

tcp        0      0 127.0.0.1:12345         127.0.0.1:59408         TIME_WAIT   -                    timewait (28.18/0/0)

此时再次启动服务端，发现报错了：

Traceback (most recent call last):
  File "server.py", line 5, in <module>
    s.bind(('0.0.0.0', 12345))
OSError: [Errno 98] Address already in use

解决方案

使用 setsockopt ：

import socket
s = socket.socket()
s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
s.bind(('0.0.0.0', 12345))
s.listen()
(client, addr) = s.accept()
print(client)
print(addr)

此时就不会出现地址被占用的提示了

在 c 中也有一样的方法，只是方法声明不同， c 版的用法为

struct sockaddr_in addr;
addr.sin_family = AF_INET;
addr.sin_port = htons(12345);
addr.sin_addr.s_addr = htonl(INADDR_ANY);
int s = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
int reuse = 1;
setsockopt(s, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse));
bind(s, (struct sockaddr *) &addr, sizeof(addr))
listen(s, )
struct sockaddr_in in_addr;
int len = sizeof(in_addr);
int client = accept(socket, (struct sockaddr *) in_addr, &len);
//handle client
//...