starlette 返回 json 响应需实例化 jsonresponse 类并传入字典数据。该操作会自动将数据序列化为 json 字符串,设置正确的 content-type 为 application/json,并处理编码问题。

如何构建包含嵌套数据的 JSON 响应
直接传递包含列表或嵌套字典的 Python 对象给 JSONResponse 即可。序列化器会递归处理这些结构,无需手动转换格式。

一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
from starlette.responses import JSONResponse
def get_user_data(request):
data = {
"id": 1,
"name": "Alice",
"roles": ["admin", "user"]
}
return JSONResponse(content=data)如何处理非标准类型的序列化错误
当数据中包含日期、集合等不可直接序列化的类型时,需自定义编码器或预处理数据。默认行为会抛出异常,因此必须在传入前确保所有值均为 JSON 兼容类型。

import json
from datetime import datetime
from starlette.responses import JSONResponse
def get_timestamp_response(request):
try:
data = {"time": datetime.now()}
# 直接使用默认编码器会失败
return JSONResponse(content=data)
except TypeError:
# 修正:转换为 ISO 格式字符串
fixed_data = {"time": datetime.now().isoformat()}
return JSONResponse(content=fixed_data)

















