asyncio.create_task() 不自动继承父任务上下文变量，因其创建新任务时不拷贝当前 contextvars.Context，导致子任务使用空上下文，trace_id_var 等变量读取为 None。
为什么 asyncio.create_task() 无法自动继承父任务的上下文变量？
Python 的 asyncio.create_task() 默认会丢弃当前 contextvars.Context，新任务从干净的空上下文启动。这意味着你在主协程里 set 过的 trace_id_var，在子任务里读出来是 None —— 这是链路断裂最常见原因。
根本原因是：task 创建时未显式拷贝当前上下文。官方文档明确指出，create_task() 不保证上下文传播，尤其在 Python
- ✅ 正确做法：用
asyncio.create_task(coro, context=copy_context()) - ❌ 错误写法：
asyncio.create_task(my_coro())（无 context 参数） - ⚠️ 注意：Python 3.11+ 才支持
context参数；3.10 及以下必须手动封装或升级
如何安全地在 async 函数间传递 TraceID 而不污染参数列表？
硬编码把 trace_id 当参数传给每个 await 调用，既难维护又破坏函数契约。更合理的方式是用 contextvars.ContextVar 做隐式透传，但必须确保每次 await 都发生在同一上下文内。
关键约束：所有异步调用必须在同一个 async with 或 try/finally 管理的上下文生命周期内完成，否则 ContextVar 会被重置。
立即学习“Python免费学习笔记（深入）”；
- 定义：
trace_id_var = ContextVar("trace_id", default=None) - 入口处 set：
trace_id_var.set(generate_trace_id()) - 子任务中读：
current_id = trace_id_var.get()（无需传参） - ⚠️ 高危场景：使用
loop.run_in_executor()时，线程切换会丢失 context —— 必须手动捕获并重新 set
在 aiohttp / httpx 客户端请求头中自动注入 TraceID 的实操方式
下游服务要继续追踪，就必须把 TraceID 通过 HTTP Header（如 X-Trace-ID）透传出去。不能靠中间件“猜”，得在发起请求那一刻就塞进去。
对 aiohttp.ClientSession，推荐用 request_class 自定义请求类；对 httpx.AsyncClient，更简单：直接 patch AsyncClient.send() 或用 EventHook。
-
aiohttp示例：继承aiohttp.ClientRequest，重写__init__，检查trace_id_var.get()并写入headers -
httpx示例：用async def on_request(request): request.headers["X-Trace-ID"] = trace_id_var.get() or ""+AsyncClient(event_hooks={"request": [on_request]}) - ⚠️ 注意：如果请求失败重试，
trace_id_var.get()仍有效 —— 但不要在重试逻辑里重复 set，避免覆盖原始值
日志中输出 TraceID 时为什么有时为空？怎么稳定绑定？
日志输出为空，90% 是因为日志语句执行时已不在原始 async 上下文里，比如被 run_in_executor 拉到线程池、或在回调函数中执行、或用了 asyncio.to_thread() 却没传上下文。
解决思路不是“让日志库支持 contextvar”，而是确保日志调用发生在可控的协程帧内，并用 logging.LoggerAdapter 封装。
- 定义 adapter：
class TraceIdAdapter(logging.LoggerAdapter): def process(self, msg, kwargs): return f"[{trace_id_var.get() or 'N/A'}] {msg}", kwargs - 使用：
logger = TraceIdAdapter(logging.getLogger(__name__), {}) - ⚠️ 关键点：adapter 只在
log.xxx()调用瞬间读取trace_id_var—— 所以必须保证 log 调用发生在正确的协程中，而不是在线程池回调里直接调用logger.info()
真正麻烦的是那些你控制不了的第三方回调（比如某些 SDK 的 on_complete hook），它们运行在未知上下文。这种地方只能提前把 trace_id 存进 callback 的闭包里，别依赖 contextvar。
