loguru默认不捕获异步请求日志，需通过basehttpmiddleware或contextvars配合patch()注入request_id，并在try/except/finally中记录耗时、状态码等完整信息。
Loguru默认不捕获异步请求日志，得手动注入
Loguru本身不自动监听 aiohttp、httpx 或 fastapi 的请求生命周期，它只管你调用 logger.info() 的地方。想让每次 GET /api/users 都自动打日志，必须在请求入口（如中间件或装饰器）里显式记录。
常见错误是直接在 async def handler() 里写 logger.info("start")，但漏掉响应时间、状态码、请求体等关键字段，导致日志碎片化、难关联。
- FastAPI 推荐用
BaseHTTPMiddleware拦截所有请求；httpx.AsyncClient调用侧则适合用EventHook或自定义 transport - 务必用
record["extra"]传上下文，比如request_id、client_ip，否则并发请求日志会混在一起 - 避免在日志中直接
str(request.body)—— 异步 body 是await request.body()，且可能已被读取一次就为空
用 Loguru 的 patch() 注入 request_id 到每条日志
异步场景下，不能靠线程局部变量（threading.local），得依赖 asyncio 的 contextvars。Loguru 的 patch() 是唯一能安全把 contextvar 值塞进每条日志 extra 的方式。
典型错误是用 logger.bind(request_id=...) 后再调用 logger.info()，但没意识到 bind 返回的是新 logger 实例，若未持续传递，下游模块仍用原始 logger，request_id 就丢了。
- 定义
request_id_var = ContextVar("request_id", default=None) - 中间件开头：
request_id_var.set(generate_id()) - 初始化 logger 时加：
logger = logger.patch(lambda record: record["extra"].update(request_id=request_id_var.get())) - 格式字符串里用
{extra[request_id]}，不是{extra.request_id}
记录耗时和状态码必须用 try/except/finally 包裹
异步请求可能因超时、连接中断、JSON 解析失败而提前退出，如果只在开头记一条日志，结尾的响应状态、耗时、错误类型全丢失。Loguru 不提供“自动结束日志”机制，必须自己控制。
别信网上抄来的“用 logger.complete()”——Loguru 根本没有这个方法。真实做法是：在 finally 块里统一补全日志字段。
- 记录开始时间用
time.perf_counter()，不是datetime.now()（后者精度低、有系统时钟跳变风险） - 状态码从
response.status_code取（FastAPI）或exc.response.status_code（异常分支） - 对
httpx客户端，推荐封装一个 async context manager，确保 enter/exit 成对触发 - 敏感字段如
Authorizationheader、password参数，需在日志前主动过滤，Loguru 不做脱敏
格式模板里禁用 {name} 和 {function}，改用 {extra[scope]}
Web 请求日志不是调试 traceback，不需要暴露模块名或函数名。默认格式里的 {name} 显示 __main__，{function} 在中间件里全是 dispatch，毫无区分度。
更糟的是，有些用户把整个 request.url.path 当 name 动态设置，结果日志文件按 module 分割失效（Loguru 的 rotation 依赖 name），还引发格式解析错误。
- 统一用
logger.configure(extra={"scope": "http"})初始化 - 格式字符串设为：
"{time:YYYY-MM-DD HH:mm:ss.SSS} | {level: - 若需区分 API 类型，用
logger.patch(lambda r: r["extra"].update(scope="api_v1"))替代改name -
{file}和{line}在中间件里恒定不变，建议删掉以减少噪音
{extra[x]}，其键名必须和 patch() 里 update(x=...) 的 key 完全一致，大小写、下划线都不能错，否则该字段永远为空。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
