讲师中心 微信公众号
AI工具推荐 视频效率加速

Python 标准库 logging 的初始化时机解析

冬萱同学_5869

冬萱同学_5869

发布时间:2026-02-15 14:33:18

|

917人浏览过

|

来源于php中文网

原创

logging.basicConfig() 在 root logger 已配置 handler 后失效,因它仅在未初始化时生效;需置于所有 import 前或使用 force=True(Python 3.8+);多模块应通过命名 logger 分级控制,避免依赖 root;多进程须用 QueueHandler 或 concurrent_log_handler 等线程/进程安全方案。

python 标准库 logging 的初始化时机解析

logging.basicConfig() 为什么在导入模块后就失效了

因为 basicConfig() 只有在 root logger 尚未配置过 handler 时才生效。一旦任意模块(比如第三方库)提前调用了 logging.info() 或显式配置了 handler,root logger 就被“污染”了,后续的 basicConfig() 直接静默退出——不报错,也不生效。

  • 典型触发场景:import requests、import scrapy、甚至某些包的 __init__.py 里偷偷打了一条日志
  • 验证方法:执行 import logging; print(logging.getLogger().handlers),非空即已初始化
  • 正确做法:把 basicConfig() 放在所有 import 之前;或改用 force=True(Python 3.8+)强制重置

多个模块共享 logging 配置但各自要不同级别怎么办

不能靠反复调 basicConfig(),得用 logger 实例分级控制。root logger 负责输出,子 logger 负责过滤——这是 logging 的设计前提。

  • 子 logger 默认继承 root 的 handler,但可独立设 level:比如 logging.getLogger('myapp.db').setLevel(logging.DEBUG)
  • 避免用 logging.getLogger()(返回 root),始终用带名字的 logging.getLogger('xxx') 获取命名 logger
  • 注意传播(propagate):设为 False 可阻止日志向上送到 root,否则可能重复打印

用 dictConfig() 加载 YAML/JSON 配置时路径不生效

常见于 filename 指向相对路径,但实际工作目录(os.getcwd())和配置文件所在目录不一致,导致日志写入失败或生成在意外位置。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限

下载
  • 错误写法:'filename': 'logs/app.log' —— 路径基于当前工作目录解析
  • 安全写法:用 pathlib.Path(__file__).parent / 'logs' / 'app.log' 拼出绝对路径,再转成字符串传入
  • dictConfig 不会自动创建父目录,os.makedirs(os.path.dirname(path), exist_ok=True) 得自己加

多进程下 logging.FileHandler 写入混乱或报错

FileHandler 不是进程安全的。多个进程同时 open 同一个文件,轻则日志交错,重则抛 OSError: [Errno 24] Too many open files。

立即学习“Python免费学习笔记(深入)”;

  • 开发/单进程场景可用 RotatingFileHandler,但生产多进程必须换方案
  • 推荐:用 QueueHandler + 单独日志进程,或直接上 concurrent_log_handler 这类第三方轮子
  • 别用 TimedRotatingFileHandler 在多进程下做 rollover——时间判断和 rename 操作无法同步
logging 最难缠的地方不在语法,而在初始化时机和多模块/多进程状态的隐式耦合。一个第三方包悄悄调一次 logging.warning(),就能让主程序的 basicConfig() 彻底失能——这种依赖关系看不见、摸不着,只能靠提前检查 root.handlers 和严格约束 import 顺序来防。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2235

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3562

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1196

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4099

2025.09.10

免费爬虫工具有哪些
免费爬虫工具有哪些

免费爬虫工具有Scrapy、Beautiful Soup、ParseHub、Octoparse、Webocton Scriptly、RoboBrowser和Goutte。更多关于免费爬虫工具的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5413

2023.11.10

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

3180

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

269

2026.02.03

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1838

2023.08.03

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

100

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn