starlette 处理 delete 请求的核心机制是路由匹配与异步视图函数的执行。开发者需要在 route 或 apirouter 中注册路径,并指定 methods=["delete"],当客户端发送请求时,starlette 的路由器会解析 url 参数,调用对应的处理函数,该函数负责执行业务逻辑(如数据库删除操作)并返回 http 响应。

如何定义支持 DELETE 的路由端点
在 Starlette 中,定义 DELETE 端点只需在初始化 Route 对象时传入 methods 参数即可。系统会根据请求方法自动分发到对应函数,无需手动检查 request.method。若未指定方法,默认仅响应 GET 请求,因此必须显式声明 DELETE 以启用该功能。

from starlette.applications import Starlette
from starlette.routing import Route
from starlette.responses import JSONResponse, Response
import asyncio
# 模拟数据库
resources = {1: "Item A", 2: "Item B"}
async def delete_resource(request):
# 从路径参数获取 ID
resource_id = int(request.path_params["id"])
if resource_id not in resources:
return JSONResponse(
status_code=404,
content={"detail": "Resource not found"}
)
del resources[resource_id]
return Response(status_code=204) # No Content
async def get_resource(request):
resource_id = int(request.path_params["id"])
if resource_id not in resources:
return JSONResponse(status_code=404, content={"detail": "Not found"})
return JSONResponse(content={"id": resource_id, "value": resources[resource_id]})
routes = [
Route("/items/{id}", endpoint=get_resource, methods=["GET"]),
Route("/items/{id}", endpoint=delete_resource, methods=["DELETE"]),
]
app = Starlette(routes=routes)
上述代码展示了完整的注册过程。访问 /items/1 并发送 DELETE 请求时,delete_resource 被调用。如果 ID 存在,资源被移除并返回 204;如果不存在,返回 404。注意,同一个 URL 模式可以注册多个路由,只要 HTTP 方法不同,Starlette 就能正确区分。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
DELETE 请求中的路径参数解析与异常处理
当 URL 包含动态段(如 {id})时,Starlette 会自动将其解析为字典放入 request.path_params。如果传入的值类型不匹配(例如期望整数但收到字符串),或者在业务逻辑中发生错误,需要捕获异常并返回适当的 HTTP 状态码。Starlette 本身不强制抛出特定异常,而是依赖开发者在视图中处理数据验证和错误反馈。

from starlette.exceptions import HTTPException
from starlette.responses import JSONResponse
async def safe_delete(request):
try:
resource_id = int(request.path_params["id"])
except ValueError:
raise HTTPException(status_code=400, detail="Invalid ID format")
if resource_id not in resources:
raise HTTPException(status_code=404, detail="Resource missing")
del resources[resource_id]
return JSONResponse(status_code=200, content={"status": "deleted"})
这段代码演示了更健壮的处理方式。使用 HTTPException 可以统一错误响应格式。当 ID 格式错误时,直接抛出 400 错误;当资源不存在时,抛出 404。这种处理方式比手动判断返回 JSON 更符合 RESTful 规范,且便于中间件统一捕获处理。在实际项目中,建议结合 Pydantic 进行更严格的数据校验。
基于删除操作后返回 204 状态码的具体问题
在成功删除资源后,标准做法是返回 HTTP 204 No Content 状态码,表示请求成功但无实体内容返回。这与返回 200 OK 并附带 JSON 确认信息不同,204 明确告知客户端资源已不存在且无需解析响应体。Starlette 的 Response 类默认支持此行为,只需设置 status_code=204 即可。若需返回确认信息,则应使用 200 并包含 JSON 数据,但这不符合纯删除操作的语义最佳实践。

















