PIP安装包间的Python日志继承问题求解

我太懂这种跨包日志配置的糟心了——用logging.getLogger(__name__)在单个包里用着顺得很，但一旦涉及到两个独立运行包+共享依赖库的架构，尤其是用Pip和Artifactory管理依赖的场景，模块命名空间带来的日志问题就立刻冒出来，查资料确实很难找到直接贴合的简洁方案。

结合我自己在多包项目里踩过的坑，给你几个实用的解决思路：

• 给共享库统一日志命名空间前缀
  别让共享库的日志记录器跟着调用它的包走，给它一个固定的根前缀。比如你的共享库叫shared_lib，那在库的每个模块里这么初始化日志器：

  import logging
  # 切割掉可能被调用包添加的前缀，保留库内的模块路径
  logger = logging.getLogger(f"shared_lib.{__name__.split('.', 1)[-1]}")
  

  这样不管是包A还是包B调用它，日志器的名称都是以shared_lib开头，完全独立于调用方的命名空间。

• 让主运行包掌控所有日志配置
  两个独立运行包是程序入口，所以所有的日志级别、处理器配置都放在它们的启动脚本里，绝对不要在共享库的代码里调用logging.basicConfig()或者添加处理器。比如在包A的启动文件里：

  import logging
  # 配置全局日志基础设置
  logging.basicConfig(
      level=logging.INFO,
      format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
  )
  # 如果需要给共享库单独设置更细致的级别
  logging.getLogger("shared_lib").setLevel(logging.DEBUG)
  

  这样共享库的日志会自动继承主包的配置，不会出现混乱。

• 用过滤器实现跨包日志的精细化区分
  如果需要区分来自包A的共享库日志和包B的，给主包的日志处理器加个自定义过滤器就行：

  class SourcePackageFilter(logging.Filter):
      def __init__(self, allowed_prefixes):
          self.allowed_prefixes = allowed_prefixes
      def filter(self, record):
          return any(record.name.startswith(prefix) for prefix in self.allowed_prefixes)
  
  # 给包A的处理器只保留包A和共享库的日志
  handler = logging.StreamHandler()
  handler.addFilter(SourcePackageFilter(["package_a", "shared_lib"]))
  logging.getLogger().addHandler(handler)
  

这些方法都是我实际项目里验证过的，能比较简洁地解决跨包时的日志模块名称问题，你可以根据自己的需求调整细节。

内容的提问来源于stack exchange，提问作者noizybrain