13-05 给错误增加定位编号

本章题解 · 全部练习

题目

在响应头和错误模型中加入一次请求的编号，让日志使用相同编号；更新 responses 与测试，再核对文档示例和实际响应。

推导与做法

中间件为一次请求建立编号，日志与响应头使用同一个值。JSON 错误正文也加入 request_id，使报错截图可以对应到日志。

TracedError 继承既有错误模型，路由 responses 引用它。测试既比较正文与 X-Request-ID，也查看 OpenAPI 是否包含新模型。CORS 预检的纯文本拒绝保持纯文本，不能强行当作 JSON 解析。

过程图

实现与运行

查看带注释实现。本题与相关处理函数放在同一章节代码文件中；启动工具负责定位相邻项目和选择题号。

在配套目录的 FastAPI/api_project 中运行。先按项目 README 执行 uv sync --locked。

# 使用项目解释器运行本题，题号决定执行哪一组演示。
uv run python "../../学习索引/参考实现/代码/ch13.py" 13-05

程序按题号输出处理后的值、查询结果或状态。先和前面的手算比较，再修改一项输入重跑。

# 与上面的手算状态和题目数值逐项比较。
{
  "status": 404,
  "request_id_matches": true,
  "documented": true
}