如何在Python多类中实现同一Logger的日志记录？

我开发Python网络爬虫已有一段时间，现在需要给它添加日志功能，方便长时间运行后查看状态、分析行为。目前我是通过传递单个主Logger实例给所有类及子类来复用，但这种到处传递的方式不够优雅，所有类都得维护这个Logger成员，想知道这类场景下日志实现的最佳实践。

原实现示例代码 #

class AppManager:
    def __init__(self):
        self.my_logger = logging.getLogger(__name__)
        # 日志配置
        self.my_scraper = WebCrawler(self.my_logger)  # 传递Logger实例给子类

    def some_function(self):
        # 执行操作出现问题时记录警告
        self.my_logger.warning("Warning message")

    def get_wp_contents(self, url):
        contents = self.my_scraper.get_wp_contents(url)

# 另一个文件中的类
class WebCrawler:
    def __init__(self, logger):
        self.my_logger = logger  # 保存Logger实例为类成员
        # 其他初始化代码

    def get_wp_contents(self, url):
        r = requests.get(url, headers=self._my_header)
        if r.status_code != 200:
            self.my_logger.critical("Bad status code")  # 使用同一个日志器记录日志
            # 错误处理逻辑
        return r.content

最佳实践方案 #

方案1：利用logging模块的层级日志器特性 #

Python的logging模块原生支持层级日志器，每个模块通过logging.getLogger(__name__)获取的日志器会自动继承根日志器（或父级日志器）的配置，完全不需要手动传递实例。

实现步骤

1. 在项目入口（比如AppManager所在的文件）统一配置日志，设置级别、格式、输出目标（文件/控制台等），只需执行一次。
2. 其他模块的类直接调用logging.getLogger(__name__)获取日志器，自动复用已有的配置。

示例代码

入口文件（app.py）

import logging
from web_crawler import WebCrawler

class AppManager:
    def __init__(self):
        # 统一配置日志（仅在入口执行一次）
        logging.basicConfig(
            level=logging.INFO,
            format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
            handlers=[
                logging.FileHandler('scraper.log'),  # 输出到文件
                logging.StreamHandler()  # 同时输出到控制台
            ]
        )
        self.my_logger = logging.getLogger(__name__)
        self.my_scraper = WebCrawler()  # 无需再传递Logger实例

    def some_function(self):
        self.my_logger.warning("执行过程出现警告")

    def get_wp_contents(self, url):
        contents = self.my_scraper.get_wp_contents(url)

爬虫模块文件（web_crawler.py）

import logging
import requests

class WebCrawler:
    def __init__(self):
        # 获取当前模块的日志器，自动继承父级配置
        self.my_logger = logging.getLogger(__name__)
        self._my_header = {"User-Agent": "Mozilla/5.0"}

    def get_wp_contents(self, url):
        r = requests.get(url, headers=self._my_header)
        if r.status_code != 200:
            self.my_logger.critical(f"请求URL {url} 返回错误状态码: {r.status_code}")
            # 错误处理逻辑
        return r.content

优势

• 完全符合Python的设计习惯，无需额外封装或传递实例。
• 日志条目会显示所属模块名称（比如app或web_crawler），方便快速定位问题来源。
• 层级日志器支持单独配置某个模块的日志级别，灵活度高。

方案2：使用基类封装日志初始化 #

如果希望所有业务类都有统一的日志获取逻辑，可以定义一个基类，在基类中完成日志器的初始化，其他业务类直接继承该基类即可，避免重复代码。

示例代码

import logging

# 封装日志逻辑的基类
class LoggedBase:
    def __init__(self):
        # 以当前类名作为日志器名称
        self.my_logger = logging.getLogger(self.__class__.__name__)

# 业务类继承基类
class AppManager(LoggedBase):
    def __init__(self):
        super().__init__()
        # 入口处统一配置日志
        logging.basicConfig(
            level=logging.INFO,
            format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
        )
        self.my_scraper = WebCrawler()

    def some_function(self):
        self.my_logger.warning("执行过程出现警告")

class WebCrawler(LoggedBase):
    def __init__(self):
        super().__init__()
        self._my_header = {"User-Agent": "Mozilla/5.0"}

    def get_wp_contents(self, url):
        r = requests.get(url, headers=self._my_header)
        if r.status_code != 200:
            self.my_logger.critical(f"请求URL {url} 返回错误状态码: {r.status_code}")
        return r.content

优势

• 统一管理日志初始化逻辑，子类无需重复编写。
• 日志器名称使用类名，便于区分不同类的日志输出。

方案3：依赖注入（适合大型项目） #

如果你的爬虫项目结构复杂、涉及大量类和模块，可以使用依赖注入框架（比如dependency-injector）来管理日志器实例，通过框架自动注入日志器，彻底消除手动传递的麻烦。不过对于中小型爬虫项目，前两种方案已经足够轻量实用。

总结 #

• 中小型项目优先选方案1：利用logging的层级特性，最简洁高效，符合Python生态的设计思路。
• 需要统一日志初始化逻辑选方案2：通过基类封装减少重复代码，保持代码整洁。
• 大型复杂项目考虑方案3：依赖注入能更好地管理实例依赖，提升代码可维护性。

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