Python使用socket.connect_ex检测端口返回0但bind报端口已占用

1 核心认知错误：connect_ex返回值含义完全颠倒 #

socket.connect_ex()是socket.connect()的无异常版本，返回值对应系统调用的错误码：

• 返回0代表TCP连接成功建立，只有目标端口处于被进程监听的占用状态时才会响应连接请求，因此返回0恰恰证明端口已被占用
• 返回非0错误码（常见如111对应连接被拒绝）才说明目标端口没有被监听，大概率可绑定

你看到的教程结论完全写反了connect_ex的判断逻辑，是导致本次异常的核心原因。

2 双栈监听规则导致的绑定冲突 #

从你的lsof输出可以看到，3389端口被绑定在IPv6通配地址*:3389。
大部分Linux发行版默认开启IPv6双栈兼容模式，绑定IPv6通配地址的TCP服务可以同时处理IPv4和IPv6请求，因此你用IPv4地址127.0.0.1发起连接可以成功拿到返回值0。
而系统端口绑定的默认规则为：只要已有进程绑定了同一端口的通配地址（无论IPv4还是IPv6），其他进程即使绑定该端口的特定IP地址，也会抛出OSError: [Errno 98] Address already in use错误。

3 可靠的端口可用检测方案 #

不建议使用connect_ex做端口占用检测，除了容易搞反判断逻辑外，还存在防火墙拦截导致误判、检测和绑定存在时间差引发竞态条件的问题。
最优方案是直接尝试绑定端口，绑定成功即证明端口可用，示例代码如下：

import socket

def is_port_available(port: int, host: str = "127.0.0.1") -> bool:
    try:
        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
            # 若需要复用TIME_WAIT状态的端口，可取消下一行注释
            # s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
            s.bind((host, port))
            return True
    except OSError:
        return False

内容的提问来源于stack exchange，提问作者Hai Hoang