Flask/FastAPI 中 logging.basicConfig() 不生效是因为框架启动时已配置 root logger,basicConfig() 仅在未配置时生效;应提前显式配置 logger 或使用框架推荐方式。

logging.basicConfig() 为什么在 Flask/FastAPI 里不生效
因为 Web 框架启动后会自动配置 root logger,basicConfig() 只在 logger 未被配置时才生效——它被框架抢跑了。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 不要依赖
basicConfig(),改用logging.getLogger()显式获取并配置 logger - 在框架初始化前就完成日志器配置(比如在
app.py最顶部 import 后立即 setup) - Flask 中推荐用
app.logger;FastAPI 则应通过logging.getLogger("uvicorn.access")和logging.getLogger("uvicorn.error")分别接管
如何给每条日志打上 request_id 实现分布式追踪
单纯靠 %(asctime)s 或 %(levelname)s 不足以串联一次跨服务请求。必须把上下文 ID 注入 logging 的 LogRecord。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 用
logging.Filter子类,在filter()方法中从当前线程/协程上下文中提取request_id(如 Flask 的g.request_id,或 FastAPI 的request.state.request_id) - 把
request_id注入到record.request_id属性,再在Formatter的format字符串里加%(request_id)s - 注意:异步场景下不能用
threading.local,得换contextvars.ContextVar(Python 3.7+)
示例关键片段:
request_id_var = ContextVar('request_id', default='N/A')<br>class RequestIdFilter(logging.Filter):<br> def filter(self, record):<br> record.request_id = request_id_var.get()<br> return True
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
JSON 格式日志怎么输出又不影响本地调试
线上需要结构化日志(方便 ELK / Loki 解析),但开发时看 JSON 是反人类的——关键是不能让两种模式互相污染。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 用环境变量控制格式,比如
LOG_FORMAT=json或dev,而不是硬编码判断 - 避免用
json.dumps()手动拼接字符串日志(会丢失 traceback 堆栈),改用支持结构化输出的logging.Formatter子类 - 第三方库如
python-json-logger可直接用,但要注意它默认把所有extra都扁平化,可能和你自定义字段冲突 - 如果用 Uvicorn,记得关掉它的默认 access log(
--access-log false),否则你会收到两份重复日志
日志丢了?检查 handler 的 flush 和 level 设置
常见现象是:程序跑着跑着突然没日志了,或者只看到 ERROR 没有 INFO —— 很大概率是 handler 缓存没刷出,或 level 被意外覆盖。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 文件 handler 默认使用
delay=True,首次写入前不创建文件;设为delay=False并显式调用handler.flush()更可控 - 确认每个 handler 的
level和 logger 自身的level都合理:logger.level ≤ handler.level 才能透出 - 多进程下别共用同一个文件 handler(会丢日志),改用
WatchedFileHandler或转向 syslog / Kafka 等外部目标 - 特别注意:Gunicorn + Flask 场景中,worker 进程继承的是主进程的 logger 配置,但 handler 实例不共享,需确保每个 worker 都独立初始化 handler
复杂点在于 request_id 的生命周期管理和跨协程传递,稍不注意就会在异步链路里变成 'N/A';还有就是不同框架对 root logger 的侵入时机差异,容易误以为配置生效了其实被覆盖了。

















