本文探讨了Python `logging` 模块配置被第三方库导入后覆盖的问题。核心在于`logging.basicConfig` 仅在根记录器未配置时生效一次。解决方案是，将日志的全局配置（如`basicConfig`调用）严格放置在程序的入口点，即`if __name__ == '__main__':` 代码块中，以确保配置只在脚本直接运行时应用，从而避免被导入模块意外修改。

引言：Python日志配置的常见陷阱

Python的 logging 模块是一个功能强大且灵活的日志记录工具。通常，我们通过 logging.basicConfig() 函数来快速设置日志的基本配置，例如日志级别、输出格式等。然而，在开发复杂的应用或集成第三方库时，开发者可能会遇到一个令人困惑的问题：即使调用了 basicConfig() 进行配置，日志的行为仍然不符合预期，甚至在导入某些模块后，原有的配置会被无声无息地覆盖或修改。这通常发生在第三方库在导入时或初始化时自行配置了日志系统，尤其是当它们调用了 basicConfig() 或向根记录器添加了处理器时。

问题重现：第三方库如何干扰日志设置

为了更好地理解这个问题，我们来看一个具体的例子。假设我们希望设置全局日志级别为 INFO，并指定一个简洁的输出格式。

import logging

# 首次配置日志
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
logging.info("TEST(info) before import chainer")
logging.critical("TEST(critical) before import chainer")

# 导入一个可能影响日志配置的第三方库，例如 chainer
import chainer

# 再次尝试配置日志，期望恢复或保持原有设置
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
logging.info("TEST(info) after import chainer")
logging.critical("TEST(critical) after import chainer")

执行上述代码，可能会得到如下输出：

INFO: TEST(info) before import chainer
CRITICAL: TEST(critical) before import chainer
TEST(critical) after import chainer

输出分析： 从输出中我们可以观察到：

1. 在导入 chainer 之前，日志配置按预期工作，INFO 和 CRITICAL 级别的消息都以 levelname: message 的格式输出。
2. 导入 chainer 之后，logging.info("TEST(info) after import chainer") 并没有输出，这表明日志级别可能被提高，或者 INFO 级别的消息被过滤了。
3. logging.critical("TEST(critical) after import chainer") 被输出了，但其格式不再是 CRITICAL: message，而是直接输出了消息内容。这说明日志的格式化器也被改变了。
4. 最关键的是，即使在导入 chainer 之后再次调用 logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")，也未能恢复或重新应用我们期望的配置。

深入理解 logging.basicConfig 的行为

造成上述问题的原因在于 logging.basicConfig() 的工作机制。basicConfig() 是一个便捷函数，用于为根记录器（root logger）设置基本的处理器（handler）和格式化器（formatter）。然而，它有一个重要的特性：basicConfig() 只在根记录器没有配置任何处理器时才会生效。

这意味着，一旦根记录器已经有了一个或多个处理器（无论是你手动添加的，还是某个导入的模块在初始化时添加的），后续对 basicConfig() 的调用将不会产生任何效果。第三方库在导入时，可能会出于调试或其他目的，向根记录器添加一个默认的 StreamHandler 或其他处理器，从而“锁定”了根记录器的基本配置，使其不再响应 basicConfig() 的调用。

解决方案：利用 if __name__ == '__main__': 保护日志配置

解决这个问题的最佳实践是确保日志的全局配置只在程序的入口点执行一次。Python提供了一个标准的机制来区分一个文件是作为主程序运行还是作为模块被导入：if __name__ == '__main__': 代码块。

将所有的日志配置代码（特别是 logging.basicConfig() 的调用）放置在这个代码块中，可以有效避免配置被意外覆盖。

短影AI

长视频一键生成精彩短视频

170 查看详情

import logging

# 确保所有日志配置都在主程序入口点进行
if __name__ == '__main__':
    logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
    logging.info("Application started.")
    logging.critical("Initial check passed.")

# 导入第三方库，即使它内部有日志配置，也不会影响我们主程序的根记录器
import chainer

# 应用程序的其他逻辑
def main():
    logging.info("Executing main application logic.")
    # 假设 chainer 在其内部也会产生日志
    # chainer.some_function_that_logs()
    logging.critical("Application finished.")

if __name__ == '__main__':
    logging.info("TEST(info) before import chainer (inside main block)")
    logging.critical("TEST(critical) before import chainer (inside main block)")
    main()
    logging.info("TEST(info) after import chainer (inside main block)")
    logging.critical("TEST(critical) after import chainer (inside main block)")

原理阐释： 当一个Python文件作为主脚本直接运行时，其 __name__ 变量的值是 '__main__'。而当它被作为模块导入时，__name__ 的值是其模块名。通过将 logging.basicConfig() 调用放在 if __name__ == '__main__': 块中，我们保证了：

1. 独立性： 只有当你的脚本是程序的入口点时，才会执行日志配置。
2. 隔离性： 当你的脚本被其他模块导入时，这段配置代码不会执行，因此不会意外地修改导入者的日志配置。
3. 优先级： 你的应用程序的根记录器配置会首先建立，第三方库随后导入时，如果它们尝试配置根记录器，将因根记录器已存在处理器而无效。如果它们使用自己的命名记录器，则这些记录器的日志消息会向上冒泡到你的已配置根记录器，并遵循你的格式和级别设置。

最佳实践与注意事项

1. 模块日志的最佳实践：

   • 不要在模块中调用 basicConfig()： 任何可重用的模块都应避免调用 logging.basicConfig() 或直接向根记录器添加处理器。模块的职责是记录它自己的事件，而不是配置整个应用程序的日志系统。

   • 使用命名记录器： 模块应创建自己的命名记录器，例如 logger = logging.getLogger(__name__)。这样，日志消息会通过记录器层次结构向上冒泡到根记录器，最终由应用程序的全局配置来处理。

   • 示例模块日志：

     # my_module.py
     import logging
     logger = logging.getLogger(__name__)
     
     def do_something():
         logger.info("Doing something important in my_module.")
         logger.debug("Debug info from my_module.")

     当 my_module 被主程序导入并调用 do_something() 时，logger.info 和 logger.debug 的消息将根据主程序的根记录器配置进行处理。

2. 更复杂的日志配置方法： 对于更复杂的日志需求，例如多个处理器、过滤器、自定义格式化器等，推荐使用 logging.config.dictConfig() 或 logging.config.fileConfig() 从字典或配置文件加载配置。这些方法提供了更强大的控制力，并且同样应该在 if __name__ == '__main__': 块中调用。

   import logging.config
   import os
   
   if __name__ == '__main__':
       # 假设 logging_config.py 是一个包含日志配置字典的文件
       # 或者直接定义配置字典
       LOGGING_CONFIG = {
           'version': 1,
           'disable_existing_loggers': False, # 关键：不要禁用现有记录器
           'formatters': {
               'standard': {
                   'format': '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
               },
           },
           'handlers': {
               'console': {
                   'level': 'INFO',
                   'class': 'logging.StreamHandler',
                   'formatter': 'standard',
               },
           },
           'loggers': {
               '': {  # 根记录器
                   'handlers': ['console'],
                   'level': 'INFO',
                   'propagate': True
               },
               'chainer': { # 可以为特定库配置日志级别
                   'handlers': ['console'],
                   'level': 'WARNING',
                   'propagate': False # 不向上冒泡到根记录器
               }
           }
       }
       logging.config.dictConfig(LOGGING_CONFIG)
       logging.info("Application started with dictConfig.")

3. disable_existing_loggers 参数： 在使用 dictConfig 或 fileConfig 时，disable_existing_loggers 参数默认为 True，这会禁用所有非在配置中明确指定的现有记录器。通常建议将其设置为 False，以避免意外地禁用第三方库的日志功能。

总结

Python logging 模块的配置行为，特别是 basicConfig() 的一次性生效机制，是导致日志配置被第三方库覆盖问题的根源。通过将应用程序的全局日志配置严格限定在 if __name__ == '__main__': 代码块中，我们可以有效地保护我们的日志设置，确保应用程序的日志行为始终符合预期。同时，遵循模块使用命名记录器的最佳实践，将有助于构建更健壮、更易于维护的Python应用程序。

以上就是Python logging 模块配置最佳实践：避免被第三方库覆盖的详细内容，更多请关注其它相关文章！

# 自己的  # 营销联盟如何做推广  # 市中区seo优化收费标准  # 推广一个新上线的网站  # 成都小企业网站建设服务  # 淮滨今日头条推广营销  # 整合营销及推广公司招聘  # 台州外贸推广网络营销  # 重庆seo公司收费标准最新  # 鄞州专业网站优化怎样做  # seo主管的工资是多少  # 多个  # 只在  # 是一个  # python  # 自定义  # 应用程序  # 主程序  # 第三方  # 记录器  # asic  # gate  # 配置文件  # stream  # ai  # 工具  # app  # 处理器 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： 提升屏幕阅读器对“m”时间单位的播报准确性：HTML与CSS组合解决方案  Yandex免登录官网入口_俄罗斯Yandex搜索引擎直达链接  Sublime Text怎么设置垂直标尺_Sublime配置Rulers规范代码长度  BetterDiscord插件中安全更新用户简介的实践指南  React/Next.js中实现列表项的动态选择与移动  MAC怎么让Dock栏只显示当前运行的应用_MAC终端命令实现极简Dock栏  qq浏览器打开空白页怎么办 qq浏览器启动后显示白屏的解决教程  PySpark中高效提取字符串右侧可变长度数字：使用regexp_extract  在Runstone环境中高效处理TasteDive API的JSON数据  小米14应用无法联网原因分析_小米14网络权限修复  J*a中实现Go语言select通道多路复用机制  C++指针和引用有什么区别_C++内存管理核心概念深度解析  J*aScript生成器_j*ascript异步迭代  初次安装JDK时环境变量如何正确配置_J*A_HOME与PATH设置规则讲解  谷歌浏览器最新官方入口链接 谷歌浏览器网页版官网导航  三星GalaxyZFold5怎样在相册制作折叠屏分镜_iPhone三星GalaxyZFold5相册制作折叠屏分镜【创意编辑】  文本文档写html代码怎么运行_文本文档html代码运行步骤【教程】  PyTorch模型训练效果不佳？深入剖析常见错误与调试技巧  在J*a中如何开发简易博客标签推荐系统_博客标签推荐项目实战解析  百度浏览器字体显示异常偏小_百度浏览器字体渲染修复方案  MinIO大规模对象列表性能瓶颈深度解析与外部元数据管理策略  Win11如何使用Windows Sandbox Win11沙盒功能开启与使用教程【详解】  正确连接J*aScript到HTML实现可点击图片与自定义事件处理  抖音商城签到领现金是真的吗_抖音商城签到奖励与提现说明  Safari怎么安装扩展程序 浏览器插件安装与管理方法【详解】  优化LangChain文档加载与ChromaDB集成：解决多文档处理与分块问题  Lar*el Excel导入时生成自定义递增ID的策略与实践  Golang如何实现Web接口签名验证_Golang Web接口签名校验开发方法  谷歌google账号注册详细步骤 谷歌账号注册官方教程  sublime如何处理大型CSV文件的列对齐_sublime高级表格编辑插件指南  必由学登录入口 必由学官方网站在线访问链接  漫蛙官网正版漫画入口 漫蛙2官方网页登录地址  小红书网页版入口链接分享 小红书官网直接进  J*aScript中安全有效地处理localStorage字符串数据  如何为你的Composer包编写自动化测试_集成PHPUnit到Composer的scripts工作流  QQ邮箱网页版快速登录 QQ邮箱邮箱账号官方入口地址  Django表单提交验证失败后保持字段值不刷新  Animex动漫社网入口地址 Animex动漫社网正版在线入口  163邮箱注册官网 免费申请163个人邮箱  蛙漫2台版漫画地址 Manwa2正版网页版链接  qq游戏免费畅玩入口_qq游戏电脑版快速启动  sublime如何优雅地处理行尾空格_sublime自动清理多余空白字符配置  零跑汽车11月交付量达70327台 实现连续9个月正增长  steam官方网页快速访问 steam账号注册全流程  解决Django多数据库/多Schema环境下外键迁移问题  Node.js中HTML按钮与J*aScript函数交互的正确姿势  京东单号查询入口_京东快递订单追踪入口  如何使用 Excel 发布器与 Power BI 分享 Excel 洞察  Python字典中优雅地迭代剩余元素的方法  豆包手机助手发布技术预览版：直接嵌入手机系统！努比亚样机发售