如何让Python Logger非全局？避免多客户端共享同名实例

能不能创建名称相同但实例不同的Logger？ #

可以，但无法通过logging.getLogger实现——这个方法是基于名称的单例模式，相同名称会返回同一个实例。要生成同名但独立的Logger实例，只能直接实例化logging.Logger类，但这么做存在一些潜在问题。

直接实例化logging.Logger的问题 #

官方文档不推荐直接实例化，核心原因包括：

• 脱离全局管理体系：logging.getLogger维护着全局的Logger实例字典，直接实例化的Logger不会被纳入这个体系，无法通过logging.getLogger(name)获取，也不受全局配置（比如logging.basicConfig）影响。
• 缺失默认继承链：通过getLogger创建的Logger会自动继承根Logger的级别、Handler等配置，直接实例化的Logger如果不手动设置父Logger，就不会继承这些配置，可能导致日志无法正常输出（除非手动添加所有需要的Handler）。
• 资源泄漏风险：频繁创建新实例且未正确清理Handler（比如关闭文件句柄），在多客户端高频调用的场景下，容易引发文件句柄泄漏问题。

针对你的场景的解决方案 #

你的核心需求是每个api_func调用都获得独立Logger，不受case_name重复影响，以下两种方案更稳妥：

方案1：用唯一标识作为Logger名称 #

无需创建同名Logger，给每个调用生成唯一名称（比如结合case_name和短UUID），既遵循logging模块规则，又能保证实例独立：

import logging
import os
import uuid

def get_logger(project_dir: str, case_name: str) -> logging.Logger:
    # 生成唯一Logger名称，避免重复实例
    unique_name = f"{case_name}_{uuid.uuid4().hex[:8]}"
    logger = logging.getLogger(unique_name)
    logger.setLevel(logging.INFO)
    # 避免重复添加Handler（防止意外复用实例）
    if not logger.handlers:
        fh = logging.FileHandler(
            os.path.join(project_dir, 'file.log'),
            delay=True,
        )
        logger.addHandler(fh)
    return logger

方案2：手动实例化并管理生命周期 #

如果一定要创建同名但独立的实例，可以直接实例化，但必须手动清理资源：

import logging
import os

def get_logger(project_dir: str, case_name: str) -> logging.Logger:
    # 直接实例化同名Logger
    logger = logging.Logger(case_name)
    logger.setLevel(logging.INFO)
    fh = logging.FileHandler(
        os.path.join(project_dir, 'file.log'),
        delay=True,
    )
    logger.addHandler(fh)
    return logger

使用时需在业务逻辑执行完毕后清理Handler，避免资源泄漏：

def api_func(project_dir: str, case_name: str) -> None:
    logger = get_logger(project_dir, case_name)
    try:
        some_use_case(logger)
    finally:
        # 清理并关闭所有Handler
        for handler in logger.handlers[:]:
            handler.close()
            logger.removeHandler(handler)

额外提醒：原代码的隐患 #

你的原代码每次调用get_logger都会给同一个Logger实例添加新的FileHandler，即使case_name不同但重复调用，也会导致日志重复写入。无论采用哪种方案，都要先检查Logger是否已有Handler再添加，或确保实例仅创建一次。

内容的提问来源于stack exchange，提问作者Maxim Ivanov