Python 3.11.7 的服务里有一段日志配置,跑单元测试时每条 INFO 都打印两遍,第一遍带时间戳,第二遍是裸格式。生产上用 guniCorn 起了 4 个 worker,一个请求的日志在文件里出现 8 行,同一个 trace_id 被算了两次,报表里的请求量直接翻倍。
第一反应是代码里重复调用了 basicConfig。全局搜了一遍只有一处,还包在 if not logger.handlers 里,理论上不该重复注册。
把 logger.handlers 打出来才看清:root 上挂了 2 个 StreamHandler,业务 logger 上挂了 1 个,propagate 默认是 True。日志先被业务 logger 处理一次,再冒泡到 root 又处理一次,第二轮用的还是 root 的格式,所以看着像两条不同的日志。
试过把 propagate 设成 False,重复没了,但第三方库的告警也跟着消失,排障时少一层信息。也试过在每个模块开头清空 handler 再重建,热重载时会出现 handler 短暂为空,几秒内的日志直接丢了。
改法是两件事:入口只配置一次 root,业务 logger 不挂 handler 只设 level,靠 propagate 统一输出;需要单独写文件的模块才加 handler 并把 propagate 关掉。gunicorn 的 --log-config 和代码里的配置会打架,这层要么全交给 gunicorn,要么全交给代码,混着来必然多一份。
确认口径:单进程跑 100 次请求,日志正好 100 行;4 个 worker 下同一个 trace_id 只有 1 条;打印 root 的 handlers 数量恒为 1。
import logging
root = logging.getLogger()
if not root.handlers:
logging.basicConfig(level=logging.INFO)
app_log = logging.getLogger("app")
app_log.propagate = True 