Python如何实现一个简单的Web服务器

Python作为一门功能丰富的编程语言，内置了多个可用于网络编程的标准库，通过这些库我们可以不依赖第三方框架，从零开始实现一个简单的Web服务器，理解Web服务的基本运行逻辑。

实现Web服务器的核心原理

Web服务器的本质是接收客户端的HTTP请求，解析请求内容，然后返回对应的响应数据。整个过程主要依赖两个核心部分：一是socket模块实现底层的网络通信，二是遵循HTTP协议的请求响应规范。

HTTP协议是客户端和服务器之间通信的规则，请求通常包含请求行、请求头、请求体，响应则包含状态行、响应头、响应体。我们的简单服务器只需要处理基础的GET请求，返回静态页面或者简单文本即可。

基础版Web服务器实现步骤

1. 导入所需模块

我们首先导入socket模块用于创建网络通信套接字，导入threading模块实现多线程处理请求，避免单个请求阻塞整个服务。

2. 创建socket并绑定端口

使用socket.socket创建TCP类型的套接字，绑定到指定的IP和端口，然后开启监听等待客户端连接。

import socket
import threading

# 定义服务器绑定的IP和端口
SERVER_IP = "127.0.0.1"
SERVER_PORT = 8080

# 创建TCP套接字
server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
# 设置端口复用，避免服务重启时端口被占用
server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
# 绑定IP和端口
server_socket.bind((SERVER_IP, SERVER_PORT))
# 开启监听，最大等待连接数为5
server_socket.listen(5)
print(f"服务器已启动，监听地址：{SERVER_IP}:{SERVER_PORT}")

3. 处理客户端请求

当有客户端连接时，我们需要接收客户端发送的请求数据，解析出请求的路径，然后返回对应的响应内容。这里先实现返回固定文本的基础版本。

def handle_request(client_socket, client_addr):
    """处理单个客户端请求的函数"""
    try:
        # 接收客户端请求数据，最大接收1024字节
        request_data = client_socket.recv(1024).decode("utf-8")
        if not request_data:
            return
        # 解析请求行，获取请求路径
        request_line = request_data.split("rn")[0]
        request_method, request_path, _ = request_line.split(" ")
        print(f"收到来自{client_addr}的{request_method}请求，路径：{request_path}")
        
        # 构造HTTP响应内容
        response_status = "HTTP/1.1 200 OKrn"
        response_headers = "Content-Type: text/html; charset=utf-8rn"
        response_body = f"<h1>欢迎访问简单Web服务器</h1><p>你请求的路径是：{request_path}</p>"
        # 拼接完整的响应，注意头部和主体之间要有两个换行
        response = response_status + response_headers + "rn" + response_body
        
        # 发送响应给客户端
        client_socket.send(response.encode("utf-8"))
    except Exception as e:
        print(f"处理请求时出错：{e}")
    finally:
        # 关闭客户端套接字
        client_socket.close()

# 主循环，持续接收客户端连接
while True:
    client_socket, client_addr = server_socket.accept()
    print(f"新的客户端连接：{client_addr}")
    # 创建新线程处理请求，避免阻塞主线程
    client_thread = threading.Thread(target=handle_request, args=(client_socket, client_addr))
    client_thread.start()

4. 运行测试

将上面的代码保存为simple_server.py，运行后在浏览器中访问http://127.0.0.1:8080/test，就能看到返回的页面内容，页面中会显示你请求的路径信息。

扩展功能：返回静态文件

基础的服务器只能返回固定文本，我们可以扩展功能，让它根据请求路径返回对应的静态文件，比如HTML、CSS、图片等。首先需要定义静态文件存放的目录，然后读取文件内容返回。

import os

# 静态文件存放的根目录
STATIC_DIR = "./static"

def handle_request_with_static(client_socket, client_addr):
    """支持静态文件的请求处理函数"""
    try:
        request_data = client_socket.recv(1024).decode("utf-8")
        if not request_data:
            return
        request_line = request_data.split("rn")[0]
        request_method, request_path, _ = request_line.split(" ")
        print(f"收到来自{client_addr}的{request_method}请求，路径：{request_path}")
        
        # 如果请求路径是根路径，默认返回index.html
        if request_path == "/":
            request_path = "/index.html"
        # 拼接文件路径，注意去掉路径开头的/
        file_path = STATIC_DIR + request_path
        
        # 判断文件是否存在
        if os.path.exists(file_path) and os.path.isfile(file_path):
            # 读取文件内容
            with open(file_path, "rb") as f:
                file_content = f.read()
            # 构造响应
            response_status = "HTTP/1.1 200 OKrn"
            # 简单根据文件后缀设置Content-Type，实际场景可以更完善
            if file_path.endswith(".html"):
                content_type = "text/html; charset=utf-8"
            elif file_path.endswith(".css"):
                content_type = "text/css"
            elif file_path.endswith(".js"):
                content_type = "application/javascript"
            else:
                content_type = "application/octet-stream"
            response_headers = f"Content-Type: {content_type}rn"
            response = response_status + response_headers + "rn"
            # 发送响应头
            client_socket.send(response.encode("utf-8"))
            # 发送文件内容，二进制直接发送
            client_socket.send(file_content)
        else:
            # 文件不存在，返回404
            response_status = "HTTP/1.1 404 Not Foundrn"
            response_headers = "Content-Type: text/html; charset=utf-8rn"
            response_body = "<h1>404 页面未找到</h1>"
            response = response_status + response_headers + "rn" + response_body
            client_socket.send(response.encode("utf-8"))
    except Exception as e:
        print(f"处理请求时出错：{e}")
    finally:
        client_socket.close()

使用这个扩展版本时，只需要在代码同级目录创建static文件夹，把HTML等静态文件放进去，访问对应路径就能返回文件内容了。

注意事项

• 这个简单服务器仅用于学习原理，没有做完善的错误处理和性能优化，不适合生产环境使用。
• 如果需要更完善的Web服务，建议使用Flask、Django等成熟的Python Web框架，它们已经封装了所有底层逻辑，开发效率更高。
• 端口选择时尽量避免使用已经被其他服务占用的端口，常见Web服务端口是80和443，测试时可以用8080等高位端口。

PythonWeb服务器socketHTTP协议http_server修改时间：2026-07-13 06:00:28