starlette 解析 json 请求体主要依赖 request.json() 方法,该方法会自动读取请求体并调用 python 标准库的 json.loads 进行反序列化。开发者只需在异步视图函数中调用此方法即可获取解析后的字典或列表对象。如果请求头 content-type 不是 application/json 或者请求体为空,该方法会抛出 httpexception 异常。

如何验证请求体的数据格式?
要验证请求体数据的格式,通常结合使用 Starlette 的路由机制与第三方校验库如 pydantic。在路由处理函数中,可以直接将 Request 对象传递给依赖注入系统,或者手动调用 request.json() 后传入 Pydantic 模型进行实例化。Pydantic 会在初始化时自动执行类型检查和数据转换,若格式不符则抛出 ValidationError。这种方式比手动检查键值对更安全且代码更简洁。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.requests import Request
from pydantic import BaseModel, Field
class UserInput(BaseModel):
name: str = Field(..., min_length=1)
age: int
app = Starlette()
@app.route("/users", methods=["POST"])
async def create_user(request: Request):
try:
body = await request.json()
user_data = UserInput(**body)
return JSONResponse({"status": "ok", "data": user_data.dict()})
except Exception as e:
return JSONResponse({"error": str(e)}, status_code=400)
如何处理非 JSON 类型的请求体?
当请求体不是 JSON 格式(例如表单数据或纯文本)时,Request.json() 会直接报错。此时应改用 request.form() 解析表单数据,或使用 request.body() 获取原始字节流。对于表单数据,form() 返回一个类似字典的对象,支持异步迭代和键值访问。开发者需根据客户端发送的 Content-Type 头决定使用哪种解析方法,避免混合使用导致的数据解析错误。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。

from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.requests import Request
app = Starlette()
@app.route("/text", methods=["POST"])
async def handle_text(request: Request):
# 假设 Content-Type 为 text/plain
body_bytes = await request.body()
text_content = body_bytes.decode("utf-8")
return PlainTextResponse(f"Received: {text_content}")
@app.route("/form", methods=["POST"])
async def handle_form(request: Request):
# 假设 Content-Type 为 application/x-www-form-urlencoded
form_data = await request.form()
username = form_data.get("username", "guest")
return PlainTextResponse(f"User: {username}")
基于程序中某个输入、条件或结果的具体问题
在 Starlette 中,如果请求体为空字符串或仅包含空白字符,Request.json() 会抛出 JSONDecodeError,进而被框架捕获并转换为 400 Bad Request 响应。这是因为 json.loads 无法解析空内容。开发者应在调用 request.json() 前通过 await request.body() 检查内容是否为空,或在异常处理块中明确区分空体与其他格式错误,以便提供更友好的错误提示。










