Python WSGI接口详解与wsgiref服务器实战

阿橙

发布时间：2026-10-14| 3人浏览过

原创

本文解析HTTP请求与响应的标准格式，重点介绍Python WSGI接口的定义规范，即通过environ和start_response两个参数处理Web请求。同时演示如何使用Python内置的wsgiref模块快速搭建本地WSGI服务器，包括代码编写、启动命令及访问测试，帮助开发者理解Python Web服务的基础运行机制。

HTTP请求与响应格式解析

HTTP协议定义了客户端与服务器通信的基本格式。以GET请求为例，其标准结构如下：


GET /path HTTP/1.1
Header1: Value1
Header2: Value2
Header3: Value3

在HTTP协议中，每个Header字段独占一行，行尾使用\r\n作为换行符进行分隔。

与GET请求不同，HTTP POST请求的格式结构如下所示：


POST /path HTTP/1.1
Header1: Value1
Header2: Value2
Header3: Value3

body data goes here...

解析HTTP报文时，当检测到连续两个（即空行）出现时，标志着Header部分的结束，此后所有的内容均被视为Body数据部分。

HTTP响应的格式结构与请求类似，具体表现如下：


200 OK
Header1: Value1
Header2: Value2
Header3: Value3

body data goes here...

若HTTP响应中包含Body数据，同样通过\r\n\r\n（即两个连续的换行符）将Header与Body分隔开。需要注意的是，Body的具体数据类型由Content-Type响应头决定：若该头值为网页类型，Body即为文本内容；若为图片类型，Body则为图片的二进制数据。

如果响应头中包含Content-Encoding字段，则表明Body数据经过了压缩处理，其中最常见的压缩算法为gzip。

WSGI接口定义规范

WSGI（Web Server Gateway Interface，Web服务器网关接口）是Python Web应用的标准规范。

WSGI接口的定义非常简洁，开发者只需实现一个特定的Python函数，即可处理HTTP请求并返回响应。


# hello.py

def application(environ, start_response):
  start_response('200 OK', [('Content-Type', 'text/html')])
  body = '<h1>Hello, %s!</h1>' % (environ['PATH_INFO'][1:] or 'web')
  return [body.encode('utf-8')]

该WSGI函数必须接收两个参数：

environ：这是一个包含所有HTTP请求信息的dict对象，提供了请求的元数据。
start_response：这是一个用于发送HTTP状态码和响应头的函数，用于启动响应过程。

使用wsgiref启动WSGI服务器

Python标准库内置了一个WSGI服务器模块，名为wsgiref。这是用纯Python编写的WSGI服务器参考实现，可用于开发和测试。


# server.py

from wsgiref.simple_server import make_server
from hello import application

# 创建一个服务器，IP地址为空，端口是8000，处理函数是application:
httpd = make_server('', 8000, application)
print('Serving HTTP on port 8000...')
# 开始监听HTTP请求:
httpd.serve_forever()

在命令行环境中，执行python server.py命令即可启动WSGI服务器。

服务器启动成功后，在浏览器地址栏输入http://localhost:8000/即可访问并查看运行结果。

若需停止服务器运行，在终端窗口按Ctrl+C组合键即可终止服务进程。

以上是对Python WSGI接口及其服务运行方式的详细解析，更多Python WSGI相关技术内容，欢迎持续关注本站后续文章。