Python 编写简易 Web 应用框架实战指南

启服和停服

启动服务器

直接运行命令或加载配置文件：

uwsgi --http :8080
# 或
uwsgi -ini app.ini

关闭服务器

通过向进程发送信号来关闭，对应的信号为 SIGINT (即 kill -2)。

kill -2 <uwsgi_pid>

启动一个 Demo

首先编写一个符合 WSGI 标准的应用程序。WSGI 接口要求应用接收两个参数：environ (字典，包含请求信息) 和 start_response (函数，用于设置响应状态和头)。

def application(environ, start_response):
    status = "200 OK"
    headers = [("Content-type", "text/html")]
    start_response(status, headers)
    return [b'Hello, World.']

将上述代码保存为 main.py，使用 uWSGI 启动：

uwsgi --http :8080 --wsgi-file main.py

启动后，可以使用 curl 测试：

curl -v 127.0.0.1:8080/

写一个简单的 Web 应用框架

基于 WSGI 标准，我们可以封装一个更简单的路由框架，将业务逻辑与服务器解耦。

框架核心代码

创建一个 myWeb.py 文件作为框架核心：

webRoute = {}

def application(environ, start_response):
    path = environ.get('PATH_INFO', '/')

    if path in webRoute:
        func = webRoute[path]
        # 调用业务函数，传入 environ
        code, body = func(environ)

        status = "%d OK" % (code)
        headers = [("Content-type", "text/html")]
        start_response(status, headers)
        return [body.encode()]
    else:
        # 处理 404 错误
        status = "404 Not Found"
        headers = [("Content-type", "text/plain")]
        start_response(status, headers)
        return [b"Page not found"]

def Routes(path, func):
    print("add routes: %s %s" % (path, func))
    webRoute[path] = func

代码解析：

1. 使用字典 webRoute 存储路由映射关系，Key 为 URL 路径，Value 为处理函数。
2. application 函数是 WSGI 入口，获取请求路径并在字典中匹配。
3. 若匹配成功，执行对应函数并根据返回值组合响应；若未匹配，返回 404。
4. Routes 装饰器或辅助函数用于注册路由。

业务逻辑代码

创建 main.py 文件，引用框架并定义具体业务：

import myWeb

# 定义应用入口
app = myWeb.application

def index(environ):
    return (200, "hello world")

def api_data(environ):
    return (200, "api response data")

# 注册路由
myWeb.Routes("/index", index)
myWeb.Routes("/api", api_data)

运行框架

使用 uWSGI 启动我们编写的框架应用：

uwsgi --http :8080 --wsgi-file main.py --callable app

注意新增的配置项 --callable app，因为我们的入口函数名定义为 app 而不是默认的 application，所以需要显式指定。

启动后观察日志，可以看到路由注册信息：

add routes: /index <function index at ...>
add routes: /api <function api_data at ...>

验证请求：

curl http://127.0.0.1:8080/index
# 输出：hello world

curl http://127.0.0.1:8080/api
# 输出：api response data

curl http://127.0.0.1:8080/notfound
# 输出：Page not found

总结

本文介绍了基于 WSGI 标准使用 Python 编写简易 Web 应用框架的方法。通过理解 WSGI 接口规范（environ 和 start_response），我们可以将 Web 应用与底层服务器解耦。利用 uWSGI 作为服务器，配合自定义的路由框架，能够快速构建轻量级的 Web 服务。这种模式不仅适用于学习，也是理解 Flask、Django 等成熟框架底层原理的基础。

在实际生产中，建议结合 Gunicorn、Nginx 反向代理以及数据库连接池等组件，以构建高可用、高性能的 Web 系统。