Python多模块日志统一_日志集中配置方案

统一日志配置需在主入口调用一次dictconfig，其余模块仅用Logging.getlogger(__name__)获取logger；根logger设默认级别并绑定处理器，子logger可单独配置，所有handler须设”propagate”: false。

python多模块项目中，日志分散配置会导致格式不一致、级别混乱、输出目标错乱，甚至出现重复打印。统一日志配置的关键在于：只在主入口（如 __main__.py 或启动脚本）中调用一次 logging.config.dictConfig() 或 basicConfig()，其余模块一律用 logging.getLogger(__name__) 获取 logger，不自行配置。

集中配置：用 dictConfig 定义全局日志行为

推荐使用字典方式配置，灵活支持处理器、过滤器、格式化器的组合。把配置字典放在独立文件（如 log_config.py）或直接在主模块顶部定义：

• 指定一个根 logger，设置默认级别（如 "INFO"），并绑定控制台和文件处理器
• 为不同模块名（如 "api"、"db"）单独配置子 logger，可覆盖级别或添加专用处理器（如仅记录 sql 到 sql.log）
• 所有 handler 必须显式设置 "propagate": False，避免日志向上冒泡到根 logger 导致重复输出

模块内规范：只获取 logger，不配置、不初始化

每个模块（api/handler.py、db/connector.py 等）开头只需：

import logging logger = logging.getLogger(__name__)

这样获得的 logger 自动继承集中配置的格式、级别和输出目标。切勿在模块中调用 basicConfig、getLogger().setLevel 或 addHandler，否则会破坏统一性。

立即学习“Python免费学习笔记（深入）”；

按需启用调试：运行时动态调整模块级别

上线后通常只需 INFO 级别，但排查问题时可能需要临时提高某模块的日志量。可在启动时读取环境变量或命令行参数：

• 例如设置 LOG_LEVEL_DB=DEBUG，在集中配置中读取该变量，为 "db" logger 单独设为 DEBUG
• 或在主程序中执行 logging.getLogger("db").setLevel(logging.DEBUG) —— 这不会影响其他模块，且比改代码重启更快

避免常见陷阱

不要在包的 __init__.py 中调用 logging 配置；不要用 print() 替代日志；不要为每个函数新建 logger 实例。统一配置后，新增模块无需任何日志相关代码，只要 import logging + getLogger(__name__) 就自动接入整个日志体系。