从零开始配置Starlette Web框架

胖浩大大_3895

胖浩大大_3895

2026-11-20

809人浏览

原创

从零开始配置 starlette web 框架,核心做法是实例化 starlette 对象并注册路由与中间件。你需要定义处理请求的异步函数,通过 @app.route() 装饰器或 app.add_route() 方法将其绑定到具体路径,最后使用 uvicorn 启动应用。这样即可得到一个支持高并发、轻量级的 web 服务。

从零开始配置Starlette Web框架

Starlette 实例如何初始化并挂载路由

初始化 Starlette 实例后,必须显式添加路由才能响应 HTTP 请求。默认情况下,实例不包含任何路由,直接运行会返回 404。开发者需要创建符合 Request 和 Response 接口的处理函数,并将其映射到 URL 模式。这一步决定了应用能接收哪些请求以及如何处理它们。

从零开始配置Starlette Web框架

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn

async def homepage(request):
    return JSONResponse({"message": "Hello World"})

routes = [
    Route("/", homepage),
]

app = Starlette(routes=routes)

if __name__ == "__main__":
    uvicorn.run(app, host="127.0.0.1", port=8000)

预期结果:访问 http://127.0.0.1:8000/ 将返回 {"message": "Hello World"}。未匹配的路径将触发默认的 404 错误处理逻辑。

如何添加自定义中间件以处理跨域或日志

在路由之外,中间件用于在请求到达处理器之前或之后执行通用逻辑。通过 app.add_middleware() 可以链式添加中间件,例如 CORSMiddleware 用于解决跨域问题,或自定义中间件用于记录请求耗时。中间件的执行顺序遵循后进先出(LIFO)原则,最后添加的中间件最先执行请求预处理,最后执行响应后处理。

Starlette 1.5.1
Starlette 1.5.1

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

下载

从零开始配置Starlette Web框架

from starlette.applications import Starlette
from starlette.middleware.cors import CORSMiddleware
from starlette.responses import PlainTextResponse
from starlette.routing import Route
import uvicorn

async def data_endpoint(request):
    return PlainTextResponse("Data received")

routes = [Route("/data", data_endpoint)]

app = Starlette(routes=routes)

# 添加 CORS 中间件,允许所有来源
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_methods=["GET", "POST"],
    allow_headers=["*"]
)

if __name__ == "__main__":
    uvicorn.run(app, host="127.0.0.1", port=8000)

预期结果:来自任意域的 GET 或 POST 请求访问 /data 时,服务器会在响应头中包含 Access-Control-Allow-Origin: *,浏览器不再拦截该请求。

当请求路径包含动态参数时如何处理

当路由定义中包含尖括号包裹的参数(如 )时,Starlette 会自动解析路径段并将其作为关键字参数传递给处理函数。开发者需在函数签名中声明同名参数,类型可指定为 str 或 int。若类型不匹配(如期望整数但收到字符串),框架将自动返回 404 而非抛出异常,这有助于保持路由系统的简洁性。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn

async def get_user(request):
    user_id = request.path_params.get("user_id")
    return JSONResponse({"user_id": user_id, "status": "found"})

routes = [
    Route("/users/{user_id}", get_user),
]

app = Starlette(routes=routes)

if __name__ == "__main__":
    uvicorn.run(app, host="127.0.0.1", port=8000)

预期结果:访问 /users/123 返回 {"user_id": "123", "status": "found"}。访问 /users/abc 同样返回上述内容,因为默认参数类型为 str。若将路由定义为 Route("/users/{user_id:int}", get_user) 且访问 /users/abc,则返回 404。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

20

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

20

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

20

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

180

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

120

15

热门下载

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

精品课程

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