starlette 返回纯文本响应需实例化 starlette.responses.plaintextresponse 对象并传入文本内容。调用该构造函数时,必须提供 text 参数指定字符串,同时可设置 status_code 控制 http 状态码(默认 200)及 headers 添加自定义头部。此方式会强制将响应头中的 content-type 设为 text/plain; charset=utf-8,确保客户端正确解析。

PlainTextResponse 的初始化参数有哪些
初始化 PlainTextResponse 主要依赖 text、status_code 和 headers 三个核心参数。text 是必填项,用于承载响应体数据;status_code 可选,默认为 200,允许开发者根据业务逻辑调整状态码(如 404 或 500);headers 为字典类型,用于注入额外的 HTTP 头部信息。这些参数直接决定了响应的结构与服务端行为。

from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def homepage(request):
return PlainTextResponse(
text="Hello, World!",
status_code=200,
headers={"X-Custom-Header": "Value"}
)
app = Starlette(routes=[Route("/", homepage)])
上述代码定义了一个简单的 Starlette 应用。当访问根路径时,homepage 函数返回一个包含 “Hello, World!” 的纯文本响应,并附带自定义头部。预期输出为 HTTP 200 状态码,响应体为指定字符串,且响应头中包含 X-Custom-Header: Value。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
如何修改响应状态码与自定义头部
在 PlainTextResponse 中修改状态码和头部只需在构造时传入相应参数即可。status_code 参数接受整数类型的 HTTP 状态码,headers 参数接受键值对形式的字典。这些设置会在响应发送前合并到标准响应头中,覆盖默认的 Content-Type 以外的其他头部。这种灵活性允许开发者在不改变响应体格式的前提下,精细控制 HTTP 协议的交互细节。

from starlette.responses import PlainTextResponse
async def not_found(request):
return PlainTextResponse(
text="Resource Not Found",
status_code=404,
headers={"Retry-After": "60"}
)
async def server_error(request):
return PlainTextResponse(
text="Internal Server Error",
status_code=500
)
以上代码展示了两种常见场景:404 错误页面和 500 服务器错误页面。前者返回 404 状态码并建议客户端 60 秒后重试,后者仅返回 500 状态码和错误提示。预期结果分别为对应的 HTTP 状态码和纯文本内容,验证了参数对响应行为的直接影响。
PlainTextResponse 遇到空字符串输入会返回什么
当 PlainTextResponse 接收到空字符串作为 text 参数时,仍会生成有效的 HTTP 响应,其状态码保持默认 200(除非显式指定其他值),响应体为空字符串,Content-Length 头部值为 0。Content-Type 依然被设置为 text/plain; charset=utf-8。这表明即使内容为空,响应结构依然完整,符合 HTTP 协议规范,不会引发错误或中断连接。

















