如何在Python中正确关闭socket连接以避免端口占用？-Python教程-PHP中文网

调用 socket.close() 后端口仍处于 time_wait 是 tcp 协议正常行为，需在 bind() 前设置 so_reuseaddr（必要）和 so_reuseport（可选）；正确关闭应先 shutdown(shut_wr)，再 recv 等待对端 fin，最后 close；多线程/进程需确保唯一所有权；asyncio 中须 await wait_closed() 而非仅 close()。

如何在python中正确关闭socket连接以避免端口占用？

socket.close() 之后端口还在 TIME_WAIT 状态怎么办

调用 socket.close() 只是释放 Python 层的 socket 对象，并不立即释放底层端口。操作系统会将该连接保留在 TIME_WAIT 状态（通常持续 2×MSL，约 60–120 秒），防止延迟数据包干扰新连接。

这不是 Python 的 bug，而是 TCP 协议设计使然。想绕过它，得在绑定前设置 socket 选项：

服务端启动时，务必在 bind() 前设置 sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
如果需要更激进地复用（比如测试频繁重启），可加 socket.SO_REUSEPORT（Linux/macOS 支持，Windows 10+ 1803 后支持）
SO_REUSEADDR 允许新 socket 绑定到处于 TIME_WAIT 的地址；SO_REUSEPORT 还允许多个 socket 同时绑定同一地址+端口（需配合不同进程或线程）

主动关闭方没发 FIN 或没等对端 ACK 就退出

Python 默认使用「优雅关闭」：调用 sock.close() 会先尝试发送 FIN，但若程序直接退出、未调用 shutdown() 或被 KeyboardInterrupt 中断，FIN 可能没发出，连接卡在 FIN_WAIT_1 或 ESTABLISHED，端口就一直被占着。

正确做法是分两步关闭：

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

先调用 sock.shutdown(socket.SHUT_WR) —— 主动发 FIN，告诉对方“我不会再发数据了”
再调用 sock.recv(1) 等待对方回 FIN（即收到 0 字节），或设超时等待 sock.settimeout(1)
最后调用 sock.close()
如果只是客户端且不关心响应，也可只做 shutdown(SHUT_RDWR) + close()，但要确保没残留 recv/send 调用阻塞

多线程/多进程里共享 socket 导致 close 失效

一个 socket 文件描述符被多个线程或子进程继承后，仅在一个地方调用 close() 并不会真正释放资源——只有所有引用都被关闭，内核才会释放端口。

常见于 fork 后父子进程都持有 socket，或线程池里传递 socket 对象：

避免跨进程共享 socket；如必须，用 sock.detach() 显式移交所有权
多线程中，确保每个 socket 实例只由一个线程负责生命周期管理
使用 contextlib.closing() 或 with socket.socket() as s: 自动保证退出时 close，但注意：这仅对当前作用域有效，不解决跨线程问题
调试时可用 lsof -i :端口号（macOS/Linux）或 netstat -ano | findstr :端口号（Windows）确认还有哪些 PID 持有该 socket

asyncio 中的 socket 关闭容易遗漏 event loop 清理

用 asyncio.open_connection() 或 loop.create_server() 创建的连接，不能只调用底层 transport 的 close()，否则 event loop 可能还保留回调引用，导致端口无法释放。

关键点在于协程与 transport 的协同关闭：

对于 client：await reader.close() + await writer.wait_closed()（后者才是真正的底层关闭）
对于 server：调用 server.close() 后，必须 await server.wait_closed()，否则 loop 仍认为 server 在运行
如果用了 asyncio.start_server()，记得保存返回的 Server 对象并显式关闭；临时 server 不关，端口就一直被 event loop 占着
event loop 本身也要正确关闭：调用 loop.close() 前确保所有 task 已 cancel 并 await 完成，否则 transport 可能泄漏