如何实现Python库始终引用主程序创建的Logger对象

Python标准库logging采用树形层级命名空间设计，核心规则如下：

• Logger名称通过.分割层级，比如名为A.B的Logger是A的子节点，所有Logger的最终根节点是名称为空的根Logger
• 子Logger产生的日志默认会沿层级向上冒泡，传递给所有祖先Logger绑定的Handler处理
• 只有存在祖先/后代关系的Logger之间才会传播日志事件

你遇到的现象完全符合这个设计逻辑：

1. 库代码test.py中通过__name__获取的Logger名称为test，它的唯一祖先是根Logger
2. 客户端创建的some.unique.path Logger和test Logger没有任何层级关联，属于完全独立的命名分支
3. 客户端仅给some.unique.path绑定了输出Handler，既没有给根Logger配置Handler，也没有给test分支的Logger做配置，自然接收不到库代码输出的日志
4. 客户端使用根Logger时功能正常，正是因为根Logger是test的祖先，能接收到冒泡上来的日志事件。

通用库绝对不要主动探测、绑定客户端自定义命名的Logger，这种做法违反logging模块的设计原则，既不可能覆盖所有客户端的自定义命名场景，还会引发日志重复打印、级别失效、Handler泄漏等难以排查的问题。

符合Python生态惯例的第三方库日志实现，只需要遵守两个规则即可满足最高扩展性要求：

• 所有模块统一使用LOG = logging.getLogger(__name__)创建模块级Logger，你当前的写法完全正确，不需要修改
• 库代码本身不要给Logger添加任何Handler、不要主动设置日志级别，所有日志配置权完全交给使用方。

针对你给出的复现场景，只需要客户端做正确配置即可得到期望输出，两种常用配置方式如下：

方式1：配置根Logger（通用场景首选） #

客户端将Handler绑定在根Logger上，所有第三方库的日志都会正常冒泡到根Logger被处理，修改后的main.py如下：

import logging
from test import somefunc

# 统一在根Logger上做配置
root_log = logging.getLogger()
root_log.setLevel(logging.DEBUG)
ch = logging.StreamHandler()
root_log.addHandler(ch)

# 业务代码可自由使用自定义命名的Logger，不影响日志接收
LOG = logging.getLogger('some.unique.path')
def main():
    LOG.info('in main')
    somefunc()

if __name__ == '__main__':
    main()

运行后即可输出期望结果。

方式2：客户端需独立使用命名Logger时手动关联层级 #

如果客户端确实要将Handler绑定在自定义命名的Logger上，只需要手动将库的根Logger挂载到自定义Logger的层级下，让日志可以正常冒泡即可，示例配置如下：

import logging
from test import somefunc

LOG = logging.getLogger('some.unique.path')
LOG.setLevel(logging.DEBUG)
ch = logging.StreamHandler()
LOG.addHandler(ch)

# 将test库的根Logger的父节点设为当前自定义Logger，打通日志传播链路
logging.getLogger('test').parent = LOG

def main():
    LOG.info('in main')
    somefunc()

if __name__ == '__main__':
    main()

注意这类层级调整的逻辑应该由客户端实现，不要写入库代码中。

不要为了兼容个别客户端的错误配置，在库代码中写遍历所有已创建Logger、猜测客户端Logger名称这类黑魔法逻辑，这类写法在多依赖的复杂项目中会引发非常多诡异的日志问题，完全不符合Python社区的日志使用共识。

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