Python日志配置失效求助：修改路径后日志格式与文件生成异常

问题描述 #

原本正常运行的日志配置代码，在修改输出路径后失效；即使改回原路径，问题仍未解决。具体异常表现：

• 日志以默认格式WARNING:root输出，与指定的自定义格式不符
• 目标log.txt文件未生成

相关代码 #

日志配置代码

logging.basicConfig(
    filename=f"{output_location}/log.txt",
    format="{asctime} - {levelname} - {filename}: {message}",
    datefmt = "%d %b %H:%M",
    style="{",
    level=logging.INFO
)

输出目录创建函数

def create_output_dir() -> Path:
    """Creates the output directory where all the log files and user facing sheets will go."""
    # 修改前：output_location = os.getcwd() + r"/output"
    output_location = os.getcwd() + r"/../output"
    path = Path(output_location)
    if not path.exists():
        msg = "A folder named 'output' has been created. All files generated will go there."
        print(msg)
        logging.info(msg)
        path.mkdir()

    return path

原因分析 #

1. logging.basicConfig仅初始化一次：Python日志系统中，basicConfig()只会在第一次被调用时生效，后续调用不会覆盖已有配置。修改路径后，create_output_dir函数中提前调用了logging.info(msg)，触发了日志系统的默认初始化；之后再执行basicConfig时，配置已无法生效——即使改回原路径，默认初始化状态也已保留。
2. 路径合法性问题：修改后的../output路径可能存在权限不足、父目录不存在等问题，导致basicConfig无法创建/写入日志文件，日志转而以默认格式输出到控制台。

解决方案 #

方案1：调整执行顺序，确保日志配置先运行 #

将logging.basicConfig()放在所有日志操作（如logging.info、logging.warning）之前执行，避免提前触发默认初始化：

# 先初始化日志配置
logging.basicConfig(
    filename=f"{output_location}/log.txt",
    format="{asctime} - {levelname} - {filename}: {message}",
    datefmt = "%d %b %H:%M",
    style="{",
    level=logging.INFO
)

# 再执行目录创建逻辑
output_location = create_output_dir()

方案2：手动重置日志配置 #

若无法调整执行顺序，可手动清除已有日志处理器后重新初始化：

# 移除所有已存在的日志处理器
for handler in logging.root.handlers[:]:
    logging.root.removeHandler(handler)

# 重新配置日志
logging.basicConfig(
    filename=f"{output_location}/log.txt",
    format="{asctime} - {levelname} - {filename}: {message}",
    datefmt = "%d %b %H:%M",
    style="{",
    level=logging.INFO
)

方案3：确保输出路径合法可写 #

优化目录创建逻辑，处理路径合法性与权限问题：

def create_output_dir() -> Path:
    output_location = os.getcwd() + r"/../output"
    path = Path(output_location).resolve()  # 转为绝对路径，避免相对路径歧义
    try:
        # 自动创建父目录，忽略已存在的情况
        path.mkdir(parents=True, exist_ok=True)
        msg = f"Output directory ready at: {path}"
        print(msg)
        logging.info(msg)
    except PermissionError:
        msg = f"Permission denied: cannot create directory {path}"
        print(msg)
        logging.error(msg)
        raise  # 根据业务需求选择抛出异常或降级处理
    return path

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