0

0

Python 日志系统 logging 的正确配置

冷炫風刃

冷炫風刃

发布时间:2026-01-31 17:52:02

|

969人浏览过

|

来源于php中文网

原创

logging.basicConfig() 在导入模块后失效,是因为根 logger 一旦被首次配置(如调用 basicConfig、getLogger 或添加 handler),后续调用将静默忽略;常见原因是第三方库提前触发了 logger 初始化。

python 日志系统 logging 的正确配置

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

因为 logging 模块的根 logger 一旦被首次配置(比如调用过 basicConfig()getLogger().setLevel() 或其他 handler 添加操作),后续再调用 basicConfig() 就直接静默返回,什么也不做——这是设计行为,不是 bug。

常见现象:主脚本开头调用了 basicConfig(),但某个第三方库或子模块里提前调用了 getLogger() 并触发了自动初始化,导致你的配置没生效。

  • 解决办法:确保 basicConfig() 是整个程序中对 logging 的**第一次操作**;更稳妥的做法是彻底不用它,改用显式配置
  • 检查是否已有库(如 requestsurllib3)偷偷初始化了 logger,可在启动时加一句 print(logging.getLogger().handlers) 看是否非空
  • 如果必须在多模块中配置,统一在入口文件用 logging.config.dictConfig()fileConfig()

如何让不同模块日志输出到不同文件且不互相干扰

关键不在 logger 名字,而在 handler 的归属和过滤逻辑。每个 logger 可以有多个 handler,但 handler 本身是共享对象,若多个 logger 共用同一个 FileHandler,就会混写。

正确做法是为每个关注模块创建独立的 logger,并绑定专属 handler:

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

CRMEB Min开源商城
CRMEB Min开源商城

CRMEB Min是CRMEB品牌全新推出的一款轻量级、高性能、前后端分离的开源电商系统,完善的后台权限管理、会员管理、订单管理、产品管理、客服系统、CMS管理、多端管理、页面DIY、数据统计、系统配置、组合数据管理、日志管理、数据库管理,一键开通短信、产品采集、物流查询等接口,系统采用TP6+Mysql+Uniapp+iView+Redis+workerman+form-builder等最流行热

下载
import logging

获取模块专属 logger(名字体现层级)

db_logger = logging.getLogger('myapp.database') api_logger = logging.getLogger('myapp.api')

各自添加互不干扰的 FileHandler

db_handler = logging.FileHandler('db.log') api_handler = logging.FileHandler('api.log')

db_logger.addHandler(db_handler) api_logger.addHandler(api_handler)

注意:必须设 level,否则默认 WARNING,INFO 不会输出

db_logger.setLevel(logging.DEBUG) api_logger.setLevel(logging.DEBUG)

  • 不要对 root logger 添加 handler,否则所有未显式配置的 logger 都会继承并输出到那里
  • 避免重复 addHandler:同一 handler 被多次 add 到同一个 logger 会导致日志重复写入
  • 若需按模块隔离又不想手动管理 handler,可用 logging.Filter 配合一个共享 handler 实现路由,但复杂度上升,小项目不推荐

logger.debug() 不输出?十有八九是 level 或 propagation 搞错了

DEBUG 不显示,90% 不是因为没调用,而是因为 logger 自身 level 太高,或者它把日志传给了父 logger(默认开启),而父 logger(通常是 root)的 level 是 WARNING。

  • 检查当前 logger 的 level:print(logger.level),注意 NOTSET=0 表示继承父级
  • 关闭传播:logger.propagate = False,防止日志向上冒泡到 root,尤其当你已为该 logger 单独配了 handler 时
  • 确认 handler 也有对应 level:handler 自身也带 level,默认是 NOTSET,但若你设了 handler.setLevel(logging.WARNING),那即使 logger 是 DEBUG,最终也会被 handler 挡掉
  • 别依赖 basicConfig(level=logging.DEBUG) —— 它只设置 root logger 和其 handler 的 level,不影响你手动创建的命名 logger

生产环境必须禁用 StreamHandler,并注意 RotatingFileHandler 的陷阱

开发时用 StreamHandler 打印到终端很爽,但上线后混着 stdout/stderr 输出会干扰容器日志采集(如 Docker、K8s)、破坏结构化日志格式,还可能因缓冲问题丢日志。

换成 RotatingFileHandler 更合适,但要注意几个实际坑点:

  • maxBytes 不是硬上限:它只控制单个文件大小,轮转时旧文件可能被重命名(如 app.log.1),但不会自动清理,需配合 backupCount 限制保留份数
  • 多进程写同一个日志文件?别这么做。RotatingFileHandler 不是进程安全的,会出现内容错乱或覆盖。应使用 WatchedFileHandler(需外部信号触发重开)或改用日志代理(如 syslog、fluentd)
  • 路径权限常被忽略:确保运行用户对日志目录有写权限,且目录存在——RotatingFileHandler 不会自动创建父目录,得自己用 os.makedirs(log_dir, exist_ok=True)

最易被忽略的一点:日志格式中的 %(asctime)s 默认精度只有毫秒,高并发下大量日志时间戳会重复;如需更高区分度,得自定义 Formatter 并用 time.time_ns() 补充纳秒字段。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

186

2023.09.27

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

258

2023.07.24

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

500

2024.04.08

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

404

2024.04.08

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

441

2024.04.08

2026赚钱平台入口大全
2026赚钱平台入口大全

2026年最新赚钱平台入口汇总,涵盖任务众包、内容创作、电商运营、技能变现等多类正规渠道,助你轻松开启副业增收之路。阅读专题下面的文章了解更多详细内容。

31

2026.01.31

高干文在线阅读网站大全
高干文在线阅读网站大全

汇集热门1v1高干文免费阅读资源,涵盖都市言情、京味大院、军旅高干等经典题材,情节紧凑、人物鲜明。阅读专题下面的文章了解更多详细内容。

20

2026.01.31

无需付费的漫画app大全
无需付费的漫画app大全

想找真正免费又无套路的漫画App?本合集精选多款永久免费、资源丰富、无广告干扰的优质漫画应用,涵盖国漫、日漫、韩漫及经典老番,满足各类阅读需求。阅读专题下面的文章了解更多详细内容。

28

2026.01.31

漫画免费在线观看地址大全
漫画免费在线观看地址大全

想找免费又资源丰富的漫画网站?本合集精选2025-2026年热门平台,涵盖国漫、日漫、韩漫等多类型作品,支持高清流畅阅读与离线缓存。阅读专题下面的文章了解更多详细内容。

4

2026.01.31

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 3.7万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号