starlette 处理 post 请求中的 json 数据,核心在于调用 request.json() 方法。该方法会自动读取请求体并尝试解析为 json 格式,若解析成功则返回对应的 python 字典或列表对象;如果请求头中未声明 content-type: application/json 或内容不是合法 json,则会抛出 jsondecodeerror 异常。

如何安全获取并验证 JSON 字段
在获取到 JSON 数据后,开发者通常需要提取特定字段并进行类型检查。直接访问字典键可能会因键不存在而引发 KeyError,因此推荐使用 .get() 方法配合默认值,或者使用第三方库如 pydantic 进行结构化验证。对于简单的场景,手动检查键是否存在是更轻量且可控的做法。

{
"username": "test_user",
"age": 25
}上述输入经 request.json() 处理后,得到 Python 字典 {"username": "test_user", "age": 25}。通过 data.get("username") 可安全获取字符串 "test_user",而 data["age"] 获取整数 25。若请求体缺少 email 键,data.get("email") 返回 None,不会报错。
将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。
如何处理非 JSON 或格式错误的请求体
当客户端发送的数据格式不符合预期时,request.json() 的行为取决于具体的错误类型。如果 Content-Type 不是 application/json,Starlette 通常不会自动解析,需手动处理或依赖中间件。如果 Content-Type 正确但 Body 内容非法(如截断的 JSON),则会抛出 starlette.datastructures.JSONDecodeError。开发者应在路由逻辑中捕获此异常,以便返回明确的 400 Bad Request 响应。

{
"invalid_json": "{ "key": }"
}该输入因语法错误导致解析失败。调用 request.json() 时触发 JSONDecodeError。程序应捕获该异常并返回 JSONResponse({"error": "Invalid JSON"}, status_code=400),确保前端能收到清晰的错误提示而非服务器内部错误。
基于 request.state 存储解析后的数据
在某些复杂应用中,解析后的 JSON 数据可能需要被多个中间件或后续路由共享。虽然 Starlette 没有内置的全局状态机制,但可以通过 request.state 对象将解析结果挂载到请求上下文中。这种方式避免了重复解析,同时保持了数据的局部性。需要注意的是,request.state 是一个通用的属性容器,适合存储任意类型的临时数据。

















