Python Socket HTTP 服务器请求阻塞问题的解决方案

大婷吖_3173

大婷吖_3173

2026-09-30

514人浏览

原创

Python Socket HTTP 服务器请求阻塞问题的解决方案

本文详解 Python 原生 socket 实现 HTTP 服务器时因单线程阻塞式 accept() 导致部分请求(如 favicon.ico)延迟处理的根本原因,并提供基于 select 的非阻塞多连接处理方案。

本文详解 python 原生 socket 实现 http 服务器时因单线程阻塞式 accept() 导致部分请求(如 favicon.ico)延迟处理的根本原因,并提供基于 select 的非阻塞多连接处理方案。

在使用 Python socket 模块手写简易 HTTP 服务器时,一个常见但易被忽视的问题是:客户端(如浏览器)并发发起多个请求(HTML、CSS、JS、favicon.ico)时,后到达的请求看似“丢失”或“延迟响应”,直到新请求触发才被处理。这并非请求未到达,而是服务器架构层面的阻塞设计所致。

你的原始代码中,serverSocket.accept() 是同步阻塞调用——每次只等待并接受一个新连接,且必须等前一个 handle_request() 完全执行完毕后,控制流才会回到 accept()。而现代浏览器默认启用 HTTP/1.1 持久连接(Keep-Alive)并行发起多个 TCP 连接(尤其加载静态资源时),这些连接会排队进入操作系统的已完成连接队列(completed connection queue)。但由于你的服务端始终只在 accept() 处“卡住”,队列中的后续连接无法被及时取出,导致请求“积压”。

更关键的是,你当前的 handle_request() 函数内部还存在逻辑缺陷:

  • has_body(HTTPStartLine) 中变量名错误(应为 requestFirstLine);
  • 判断空行的条件 line == "\r\n" or line == "\n" 在实际 HTTP 流中不可靠(\r\n 是标准,但单独 \n 可能误判);
  • 使用 makefile() 包装 socket 后,for line in incomingMessage 依赖底层缓冲,若客户端未发送完整请求(如 POST 缺少 body),迭代可能永久挂起;
  • 全局变量 id 在多连接场景下存在竞态风险(虽当前为单线程,但结构上已埋隐患)。

✅ 正确解法是让服务器具备同时监听多个 socket 的能力,避免在 accept() 或 recv() 上长期阻塞。select.select() 是最轻量、跨平台的解决方案:

Python Use Agent
Python Use Agent

智能执行Python任务,自动生成、执行代码并反馈结果,无需额外配置,兼容旧命令。

下载
import socket
import select

def handle_request(client_socket):
    """安全读取 HTTP 请求行、头、体(支持无 body 的 GET/HEAD)"""
    try:
        # 设置短超时防止无限阻塞
        client_socket.settimeout(5.0)
        data = b""
        # 读取直到遇到空行(\r\n\r\n)
        while b"\r\n\r\n" not in data:
            chunk = client_socket.recv(1024)
            if not chunk:
                return False
            data += chunk

        # 解析请求行和头部
        headers_end = data.find(b"\r\n\r\n")
        header_bytes = data[:headers_end]
        request_line = header_bytes.split(b"\r\n")[0].decode("utf-8", errors="ignore")

        # 简单判断是否有 body(检查 Content-Length 或 Transfer-Encoding)
        has_body = False
        if b"Content-Length:" in header_bytes:
            has_body = True
        elif b"Transfer-Encoding:" in header_bytes:
            has_body = True

        # 读取 body(若有)
        body = b""
        if has_body:
            # 此处需解析 Content-Length 或分块编码,简化版仅读固定长度(生产环境需完善)
            pass

        # 构造响应
        response = (
            b"HTTP/1.1 200 OK\r\n"
            b"Content-Type: text/plain\r\n"
            b"Content-Length: 12\r\n"
            b"\r\n"
            b"Hello World!"
        )
        client_socket.sendall(response)
        print(f"Handled: {request_line}")
        return True
    except (socket.timeout, ConnectionResetError, OSError) as e:
        print(f"Request error: {e}")
        return False
    finally:
        client_socket.close()

def run_server(port=9999):
    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as server_socket:
        server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
        server_socket.bind(("localhost", port))
        server_socket.listen(5)
        server_socket.setblocking(False)  # 关键:设为非阻塞

        connections = []  # 存储活跃客户端 socket
        print(f"Server listening on http://localhost:{port}")

        while True:
            # select 监听 server_socket(新连接)和所有已连接 client_socket(数据到达)
            readable, _, _ = select.select([server_socket] + connections, [], [], 1.0)

            for sock in readable:
                if sock is server_socket:
                    # 接受新连接
                    try:
                        client_socket, addr = server_socket.accept()
                        client_socket.setblocking(False)
                        connections.append(client_socket)
                        print(f"New connection from {addr}")
                    except BlockingIOError:
                        # 非阻塞模式下 accept 可能无连接可取,忽略
                        pass
                else:
                    # 处理客户端请求
                    if not handle_request(sock):
                        # 处理失败则清理连接
                        if sock in connections:
                            connections.remove(sock)

if __name__ == "__main__":
    run_server()

? 关键改进点说明:

  • server_socket.setblocking(False) + select.select() 实现事件驱动轮询,避免任何单点阻塞;
  • select 超时参数(此处设为 1.0 秒)确保循环不会无限等待,兼顾响应性与 CPU 占用;
  • handle_request 内部显式设置 recv 超时,防止因客户端异常断连导致服务僵死;
  • 移除了不安全的 makefile() 和全局计数器,改用更可控的 recv() 流式读取;
  • 响应中明确声明 Content-Length,符合 HTTP/1.1 规范,避免浏览器等待。

⚠️ 注意事项:

  • select 在 Windows 和 Linux 上均可用,但连接数上限通常为 1024(可通过 select.select() 返回值判断是否满载);
  • 若需更高性能或海量并发,应升级至 epoll(Linux)或 kqueue(macOS/BSD),或直接使用 asyncio;
  • 真实 HTTP 服务器还需处理 Connection: close、chunked encoding、HTTP/2 等,本方案聚焦解决核心阻塞问题。

通过以上重构,你的服务器将能即时响应浏览器并发发起的所有请求,不再出现 favicon.ico “延迟出现”的现象——因为每个连接都被独立、公平地轮询和处理,彻底告别单线程阻塞瓶颈。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1611

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3924

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1629

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

22597

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2787

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2827

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1123

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2183

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程