使用 pip install starlette 安装依赖后,通过创建包含路由和应用的 python 文件并调用 uvicorn 启动服务即可完成开发环境配置。starlette 本身不包含内置的 http 服务器,因此必须配合 asgi 服务器(如 uvicorn)运行。配置的核心在于定义一个 starlette 应用实例,注册路由,并在入口脚本中启动服务器监听指定端口。

如何编写 Starlette 的路由与主程序结构
Starlette 的路由系统基于路径匹配,支持将请求映射到特定的处理函数或类。在开发环境中,通常创建一个 main.py 文件,导入 Starlette 和 Route,定义异步处理函数,并将它们绑定到 routes 列表中。最后通过 uvicorn.run() 启动应用。这种结构清晰分离了路由定义和业务逻辑,便于扩展。

from starlette.applications import Starlette
from starlette.routing import Route
from starlette.responses import PlainTextResponse
import uvicorn
async def homepage(request):
return PlainTextResponse("Hello, World!")
app = Starlette(routes=[
Route("/", homepage),
])
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
如何处理动态路径参数与中间件配置
除了静态路径,Starlette 支持在路由中使用尖括号包裹的动态参数,例如 /users/{user_id}。这些参数会自动解析并作为关键字参数传递给处理函数。此外,可以通过 add_middleware 方法向应用添加中间件,用于处理跨域、日志记录或身份验证等横切关注点。中间件的执行顺序遵循后进先出原则,即最后添加的中间件最先执行请求处理,最后执行响应处理。
使用Deepgram Nova-2 API通过流式WebSocket连接进行实时语音转文本。通过Deepgram Python SDK支持说话人分离、标点符号和语言检测,适用于播客和会议转录工作流程。

from starlette.applications import Starlette
from starlette.routing import Route
from starlette.responses import JSONResponse
from starlette.middleware.cors import CORSMiddleware
import uvicorn
async def get_user(request):
user_id = request.path_params["user_id"]
return JSONResponse({"id": user_id, "name": "Alice"})
app = Starlette(routes=[
Route("/users/{user_id}", get_user),
])
# 配置 CORS 中间件
app.add_middleware(
CORSMiddleware,
allow_origins=["*"],
allow_methods=["GET"],
)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
当请求路径未匹配任何路由时返回什么结果
如果客户端发送的请求路径未在 routes 中注册,Starlette 会默认返回一个 404 Not Found 状态码。该响应体通常为空的 HTML 页面或纯文本,具体取决于底层服务器的实现,但标准行为是抛出 HTTPException 或返回默认的 404 响应。开发者无需手动处理这种情况,除非需要自定义错误页面或日志记录。若希望捕获所有未匹配请求进行特殊处理,可以添加一个通配符路由或使用异常处理中间件,但默认情况下直接返回 404。










