Python并发日志上下文管理核心是隔离而非加锁：多线程用threading.local，asyncio用contextvars；通过Filter注入LogRecord属性、Formatter动态渲染，并支持with语句临时覆盖。
Python并发日志处理中，上下文管理的核心是确保每个线程/协程拥有独立的日志记录上下文（如请求ID、用户信息等），避免日志混杂、追踪困难。关键不在“加锁写日志”，而在“隔离上下文”。
使用threading.local隔离线程上下文
多线程场景下，threading.local() 是最轻量且可靠的方式：它为每个线程提供独立的命名空间，无需显式传参或加锁。
- 在日志处理器或过滤器中，通过 local_storage.request_id 获取当前线程绑定的上下文字段
- 在请求入口（如Flask before_request、Django middleware）中设置：local_storage.request_id = generate_id()
- 避免在子线程中复用主线程的 local 实例——每个线程需独立初始化或依赖框架自动创建
asyncio场景用contextvars替代threading.local
协程切换不换线程，threading.local 失效。必须用 contextvars.ContextVar 管理异步上下文。
- 定义：request_id_var = ContextVar('request_id', default=None)
- 在协程入口设值：request_id_var.set(generate_id())
- 自定义LogRecord工厂函数中调用 request_id_var.get() 注入日志属性
- 注意：若使用 run_in_executor 执行阻塞IO，需手动复制 contextvar 到子线程（用 copy_context() + run()）
日志处理器中安全注入上下文字段
不要在日志输出时临时拼接字符串，而应通过 LogRecord 属性或 Formatter.format 动态注入，保证原子性和可扩展性。
立即学习“Python免费学习笔记（深入）”；
- 继承 logging.Filter，重写 filter(record) 方法，把上下文值赋给 record.req_id
- 在 Formatter 的 format() 中使用 %(req_id)s 占位符，无需修改原有日志语句
- 避免在 extra 参数中重复传相同上下文字段——易遗漏、难统一，应由上下文管理器自动补全
结合上下文管理器（with语句）做临时上下文覆盖
适合批处理、后台任务等需临时覆盖全局上下文的场景，比如为一个数据库事务打上 task_id。
- 定义上下文管理器类，__enter__ 中保存原值并设置新上下文，__exit__ 中恢复
- 内部仍基于 threading.local 或 contextvars 操作，确保嵌套安全
- 示例：with log_context(task_id='task_123'): logger.info("start processing")
