讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

Python logging 模块的正确配置方式

秋静酱_1810

秋静酱_1810

发布时间:2026-02-11 22:20:47

|

274人浏览过

|

来源于php中文网

原创

basicConfig 大概率不生效,因为它仅在 root logger 未被配置时才起作用;一旦第三方库(如 requests、Django)提前初始化日志,它即失效且无警告。

python logging 模块的正确配置方式

为什么 basicConfig 大概率不生效?

因为 basicConfig 只在 root logger 尚未被配置过时才起作用。一旦你或某个第三方库(比如 requests、urllib3、django)提前调用了 logging.debug() 或初始化了 handler,它就彻底失效——连 warning 都不会报。

  • 常见触发点:import requests 后首次发请求;import scrapy;Django 启动时自动配置日志
  • 验证方法:打印 logging.getLogger().handlers,非空即已被占位
  • 正确做法:要么在所有 import 之前调用 basicConfig(极难保证),要么直接放弃它,手动配置 root logger

如何安全地重置并接管 root logger?

清空已有 handlers 并显式设置 level 和输出目标,比依赖 basicConfig 更可靠,尤其在复杂项目或测试环境中。

  • 必须先清空:logging.getLogger().handlers.clear()
  • 再设 level:logging.getLogger().setLevel(logging.INFO)(注意不是 basicConfig(level=...))
  • 添加 handler 示例:
    handler = logging.StreamHandler()
    formatter = logging.Formatter('%(asctime)s %(levelname)s %(name)s: %(message)s')
    handler.setFormatter(formatter)
    logging.getLogger().addHandler(handler)
  • 警告:不要在模块顶层多次执行这套操作,否则会重复加 handler,导致日志刷屏

为什么你的日志里没有文件名和行号?

默认 formatter 不包含 %(filename)s、%(lineno)d 或 %(funcName)s,而只靠 %(name)s 很难定位到具体代码位置。

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
  • 调试阶段建议用:%(asctime)s %(levelname)-8s %(filename)s:%(lineno)d %(funcName)s - %(message)s
  • 生产环境可精简掉 %(funcName)s(有性能开销,尤其高频日志)
  • 注意:%(filename)s 是不含路径的文件名;如需完整路径,改用 %(pathname)s
  • 如果看到 <string></string> 或空字段,说明 formatter 没生效,检查是否 handler 被重复添加或 logger 被禁用

多模块协作时,子 logger 为啥不输出?

子 logger(如 logging.getLogger('db.query'))默认继承 root 的 level,但它的 propagation 默认为 True——意味着日志会“冒泡”到 root 输出一次;但如果 root 没 handler,或子 logger 自己没 handler 且 propagation 关闭,就彻底静音。

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

  • 典型误配:logger = logging.getLogger('myapp'); logger.propagate = False,但忘了给它加 handler
  • 推荐模式:只配置 root handler,所有子 logger 设 propagate=True(默认值),靠 name 区分来源
  • 需要独立输出?给子 logger 单独加 handler,但记得 propagate=False,避免重复打印
  • 别用 logger.setLevel(logging.DEBUG) 直接压低子 logger 级别——这会让它把 DEBUG 日志传上去,但 root 可能只收 INFO+,结果是“看似设了却没输出”

日志配置真正的难点不在语法,而在时机和层级关系——哪个模块先动了 root,谁悄悄关了 propagation,formatter 有没有被覆盖,这些细节一错,日志就消失得无声无息。

热门AI工具

更多
DeepSeek

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

Lovart
Lovart Hot

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

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

豆包大模型

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

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

VibeKnow
VibeKnow Hot

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

593

2026.02.04

Python Django REST Framework接口安全与认证体系实践
Python Django REST Framework接口安全与认证体系实践

本专题围绕 Django REST Framework 展开,深入讲解 API 认证、JWT 鉴权、权限控制、接口安全防护以及防攻击策略设计。通过完整后端案例,帮助开发者构建安全可靠的 Web API 服务体系。

260

2026.06.29

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

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

5773

2023.11.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7419

2023.08.02

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

80

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

40

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

80

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

60

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

60

2026.11.05

热门下载

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

精品课程

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

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