logging.basicConfig 只生效一次:之后改级别请用 setLevel
改了级别却没反应
调一段程序的日志,想临时把输出调详细些,于是在初始化后补了一行 basicConfig,把级别设成 DEBUG。跑起来发现该出的还是没出,级别压根没变。第一反应是日志配置写错了,翻了半天才明白,是第二次调用被默默忽略了。
只有第一次生效
import logging
root = logging.getLogger()
for h in root.handlers[:]:
root.removeHandler(h)
logging.basicConfig(level=logging.DEBUG)
print("after 1st:", root.level)
logging.basicConfig(level=logging.CRITICAL)
print("after 2nd:", root.level)
上面那段 for h in root.handlers[:]: root.removeHandler(h) 是为了先把根记录器上可能残留的处理器清空,模拟一个"第一次调用"的干净环境;否则运行环境里根记录器若已有 handler,首个 basicConfig 也会被跳过,反而演示不出效果。
输出:
after 1st: 10
after 2nd: 10
DEBUG 对应的数值是 10。第一次 basicConfig 把根记录器级别设成 10,第二次想改成 CRITICAL,级别却还是 10,那行调用等于没执行。DEBUG 是 10、CRITICAL 是 50,从输出能清楚看到第二次没起作用。
为什么第二次是空操作
basicConfig 的设计是:在 force=False(默认)的情况下,只要根记录器上已经挂了处理器,就直接返回,什么都不做;只有 force=True 时才会绕过这个判断去重配(见下节)。它的定位是给简单程序做一次性快速配置,不是用来反复改配置的。第一次调用时根记录器没有处理器,于是配置生效;之后处理器已经在了,再调用就整体跳过,连带的 level、format 也一起被忽略。
这个行为在文档里有写,但平时很少有人逐字读,容易想当然地把它当成随时可改的开关。而且它失败时不报错、不警告,只是静默跳过,所以问题往往到发现日志不对时才暴露。
想改级别该怎么做
配置一次,之后改级别直接动记录器对象:
import logging
logging.basicConfig(level=logging.INFO)
root = logging.getLogger()
root.setLevel(logging.DEBUG)
print("now:", root.level)
setLevel 是实打实改当前级别,不受有没有处理器的影响。想换格式、加处理器,也都是直接操作 handler 和 formatter,而不是再调一次 basicConfig。
确实要重配也有办法
Python3.8 之后 basicConfig 多了个 force 参数:
logging.basicConfig(level=logging.DEBUG, force=True)
设成 True 时,它会先移除并关闭根记录器上已有的处理器,再重新配置。这确实能让第二次生效,但要注意它会把之前挂的处理器全清掉,如果别处也往根记录器加过处理器,会被一并移除,用之前得清楚自己在动什么。
把配置集中到一处
我现在习惯在程序入口一次性配好日志,级别从配置或环境变量读,运行途中要调整就走 setLevel。这样既绕开了 basicConfig 只生效一次的坑,也不会因为散落各处的重复配置互相打架。
静默失败是最难查的一类问题,因为它不给你任何报错线索。知道 basicConfig 有这个一次性脾气,就能在改日志没反应时第一时间想到它,而不是在格式字符串里白找半天。
- 点赞
- 收藏
- 关注作者
评论(0)