logging.basicConfig配置无法生成日志文件，求解析与修复

核心原因 #

1. logging模块初始化规则限制
   logging.basicConfig仅在根logger未添加任何handler的前提下生效。如果你的代码在调用loggen()之前，已有其他地方触发过logging操作（比如导入的模块调用了logging.info()、logging.debug()等），Python会自动给根logger添加默认的StreamHandler（输出到控制台），后续再调用basicConfig就不会再添加FileHandler，自然无法生成日志文件。而手动添加FileHandler的方式不受此限制，不管根logger有没有handler，都会直接新增并生效。

2. 目录不存在的潜在问题
   如果Logs目录不存在，basicConfig不会自动创建目录，会抛出IO异常（未捕获时程序会崩溃）；若程序未崩溃但无日志文件，大概率目录已存在，但这也是需要排查的点。

修复方案 #

方案一：确保basicConfig是首次logging操作 #

把basicConfig的调用放在程序最前端，确保在任何其他logging操作前执行：

import logging
import os
from datetime import datetime

# 提前创建Logs目录，避免目录不存在问题
os.makedirs(".\\Logs", exist_ok=True)

# 先执行basicConfig，确保是首次logging配置
logging.basicConfig(
    filename=".\\Logs\\automation.log",
    filemode='a',
    format="%(asctime)s: %(levelname)s: %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S",
    level=logging.DEBUG  # 直接在basicConfig中设置级别
)

class LogGeneration:
    @staticmethod
    def loggen():
        logger = logging.getLogger()
        return logger

方案二：清空根logger现有handler（应急方案） #

如果无法避免其他地方先初始化logging，可在调用basicConfig前清空根logger的所有handler：

import logging
import os
from datetime import datetime

class LogGeneration:
    @staticmethod
    def loggen():
        os.makedirs(".\\Logs", exist_ok=True)
        logger = logging.getLogger()
        # 移除所有现有handler，确保basicConfig能生效
        for handler in logger.handlers[:]:
            logger.removeHandler(handler)
        logging.basicConfig(
            filename=".\\Logs\\automation.log",
            filemode='a',
            format="%(asctime)s: %(levelname)s: %(message)s",
            datefmt="%Y-%m-%d %H:%M:%S",
            level=logging.DEBUG
        )
        return logger

方案三：使用自定义logger（推荐） #

避免使用根logger，创建专属自定义logger，不会和其他模块的logging配置冲突：

import logging
import os
from datetime import datetime

class LogGeneration:
    @staticmethod
    def loggen():
        # 创建自定义logger
        logger = logging.getLogger("automation_logger")
        # 避免多次调用时重复添加handler，防止日志重复输出
        if not logger.handlers:
            os.makedirs(".\\Logs", exist_ok=True)
            handler = logging.FileHandler(filename=".\\Logs\\automation.log", mode='a')
            formatter = logging.Formatter("%(asctime)s: %(levelname)s: %(message)s", datefmt="%Y-%m-%d %H:%M:%S")
            handler.setFormatter(formatter)
            logger.addHandler(handler)
            logger.setLevel(logging.DEBUG)
            # 禁止日志传递到根logger，避免重复打印
            logger.propagate = False
        return logger

内容的提问来源于stack exchange，提问作者Milan Singh