Python网络超时由操作系统在系统调用未完成时返回错误触发,非解释器主动中断;连接超时发生于TCP三次握手阶段,读取超时发生于已连接后等待数据时,DNS解析不属其范畴,且实际耗时可能略超设定值。
Python 网络超时由底层 socket 层触发,不是 Python 解释器主动“计时中断”,而是当系统调用(如 connect()、recv())在指定时间内未完成时,操作系统返回错误,Python 将其封装为 socket.timeout 或更通用的 TimeoutError 异常。
发生在 TCP 三次握手阶段。调用 socket.connect() 时,若在设定时间内未收到 SYN-ACK 响应,内核返回 ETIMEDOUT(Linux)或 WSAETIMEDOUT(Windows),Python 抛出 socket.timeout。
socket.settimeout(n) 设置
connect()
socket.setsockopt(socket.SOL_SOCKET, socket.SO_RCVTIMEO, ...) 单独设接收超时,但不推荐——跨平台行为不一致timeout=(3, 7) 第一个数字即连接超时,本质是调用底层 socket 的 connect 超时发生在已建立连接后等待数据到达时。例如调用 recv() 或 readline(),若对端迟迟不发数据,且 socket 已设超时,内核在超时后返回 EAGAIN/EWOULDBLOCK,Python 转为 socket.timeout。
timeout=(3, 7) 的第二个数字即读取超时,覆盖整个响应体接收过程recv() 开始计,不是从请求发出开始不算。DNS 查询由操作系统或 libc 的 getaddrinfo() 完成,不走 socket 超时机制。它有自己的超时逻辑(如 /etc/resolv.conf 中的 timeout: 和 attempts:),Python 默认不干预。
gaierror 或 ConnectionError,而非 TimeoutError
socket.getaddrinfo(host, port, timeout=5)(Python 3.12+)控制 DNS 超时,旧版本需配合线程/asyncio 实现实际耗时可能略超设定值。原因包括: