因为basicConfig()仅在根logger未配置时生效且默认只添加一个StreamHandler,后续调用被静默忽略;多端日志需手动创建Logger并显式添加多个Handler。

为什么直接用 logging.basicConfig() 无法支持多端日志
因为 basicConfig() 只在根 logger 尚未配置时生效,且它默认只加一个 StreamHandler(输出到控制台)。一旦你尝试多次调用或想同时写文件+控制台+网络端,它就失效了——后续的 basicConfig() 调用会被静默忽略。多端日志必须手动创建 Logger 实例,并显式添加多个 Handler。
如何为同一个 logger 添加文件、控制台、HTTP 三个输出端
核心是复用同一个 Logger 对象,但给它挂多个 Handler,每个 Handler 独立设置格式、级别和目标。注意:Logger 自身的 level 是总闸门,各 Handler 的 level 是子过滤器。
- 先用
logging.getLogger("myapp")获取(或创建)命名 logger,避免污染 root - 调用
.setLevel(logging.DEBUG)开启最低粒度日志捕获 - 为文件输出添加
FileHandler("app.log"),设level=logging.INFO - 为控制台添加
StreamHandler(),设level=logging.WARNING(只报警告以上) - 若需发 HTTP,用
logging.handlers.HTTPHandler,注意它只支持 POST 且需服务端配合接收
示例关键片段:
import logging
from logging.handlers import HTTPHandler
<p>logger = logging.getLogger("myapp")
logger.setLevel(logging.DEBUG)</p><h1>文件端</h1><p>fh = logging.FileHandler("app.log")
fh.setLevel(logging.INFO)
fh.setFormatter(logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s"))
logger.addHandler(fh)</p><h1>控制台端</h1><p>sh = logging.StreamHandler()
sh.setLevel(logging.WARNING)
sh.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(sh)</p><h1>HTTP 端(假设后端监听 /log)</h1><p>http_handler = HTTPHandler("localhost:8000", "/log", method="POST")
http_handler.setLevel(logging.ERROR)
logger.addHandler(http_handler)
多进程写同一个日志文件会出问题吗
会。Python 标准 FileHandler 不做进程级同步,多进程并发写入会导致内容错乱、截断甚至丢日志。这不是 logging 模块的 bug,而是文件系统层面的竞态。
立即学习“Python免费学习笔记(深入)”;
- 单机多进程场景下,优先改用
RotatingFileHandler+delay=True并配合外部锁(如concurrent.futures.ThreadPoolExecutor不适用,得用filelock库) - 更稳妥的做法是让所有进程把日志发到一个中心进程(比如用
QueueHandler+QueueListener),由该进程统一写文件 - 若只是多线程,
FileHandler本身是线程安全的,无需额外处理
为什么日志里看不到模块名或行号,但代码里明明用了 %(filename)s 和 %(lineno)d
因为格式化字符串里的字段(如 %(filename)s)依赖 LogRecord 是否携带对应属性,而这些属性只有在调用 logger.debug() 等方法时,由 logging 框架从调用栈动态提取。如果你用了 logger.log(level, msg) 但没传 exc_info 或自定义 extra,通常不会丢;但若中间穿插了装饰器、异步回调(如 asyncio)、或用 functools.partial 包装了 logger 方法,调用栈可能被截断,导致 filename 和 lineno 回退到 logging 内部位置。
- 验证方式:临时加一句
logger.debug("test", stacklevel=1),看是否恢复正确位置 - 异步场景建议用
aiologger替代标准 logging,或确保stacklevel补偿装饰器层数 - 生产环境慎用
stacklevel > 1,它有性能开销,且容易误标
日志多端输出本身不难,难的是在多进程、异步、装饰器嵌套等真实场景下,保持各 handler 的行为稳定和上下文准确。尤其是 stacklevel 和 FileHandler 的进程安全,最容易在线上突然暴露。


















