Python logging.NullHandler 原理解析与 peewee 日志输出机制

在使用 peewee 框架时，默认情况下程序运行不会产生任何日志消息。

from peewee import Model, CharField, DateTimeField, IntegerField
from peewee_mssql import MssqlDatabase
db = MssqlDatabase(database='test', host='.', user='sa', password='sa')
class BaseModel(Model):
 class Meta:
  database = db
class Person(BaseModel):
 Name = CharField(verbose_name='姓名', max_length=20)
 Age = IntegerField(verbose_name='年龄')
 Birthday = DateTimeField(verbose_name='生日', null=True)
p = Person(Name='张三', Age='20', Birthday='2018-01-01')
p.save()

在上述代码基础上，我们引入日志配置的定义：

import logging
logger = logging.getLogger('peewee')
logger.setLevel(logging.DEBUG)
logger.addHandler(logging.StreamHandler())

此时出现了一个有趣的现象：程序运行时成功打印出了一行日志信息。

尽管我们在代码中并未显式调用任何日志记录方法，但这行日志究竟源自何处？

通过查阅 peewee 的源码，可以发现其内部已经定义了日志处理逻辑：

关于 logging.NullHandler，网络上的常见解释通常只有一句话：该 Handler 实例会忽略错误消息，通常由希望使用 logging 模块的库开发者使用，目的是避免在日志记录器未配置处理器时出现“No handlers could be found for logger XXX”的警告信息。

初看可能令人困惑，但深入理解后便十分清晰。logging.getLogger(name) 方法通过工厂模式返回一个 logger 实例；如果指定名称的 logger 已存在，则直接返回该实例。

在 peewee 库中，定义了一个名为“peewee”的 logger，并仅附加了一个 NullHandler。在我们的代码中，logger = logging.getLogger('peewee')，这行语句实际上获取了 peewee 中预先定义的 logger，并为其添加了一个 StreamHandler。因此，日志得以正常输出。不妨尝试修改代码中 logger 的名称，观察是否还能看到日志输出。

在开发 Python 库时，我们也可以采用类似方式定义一个 NullHandler，具体的日志处理逻辑交由调用者自行决定。

总结

以上介绍了 Python 中 logging.NullHandler 的使用教程，希望能对大家有所帮助。如有任何疑问，欢迎留言，小编会及时回复。感谢大家对本站的支持！