PyO3二次调用Rust函数时log4rs日志资源未释放引发Panic

核心原因 #

1. log4rs全局初始化限制：log4rs::init_config是全局单例操作，一旦调用就会设置log crate的全局Logger，二次调用必然触发panic——因为log crate不允许重复设置全局Logger。
2. 文件资源未释放：RollingFileAppender初始化后会持续持有日志文件句柄，Python进程存活期间，这些资源不会自动释放，导致文件被锁定，出现“共享冲突”。
3. flush/drop无效：调用logger().flush()仅刷新日志缓存，而drop(logger())只是丢弃了全局Logger的一个引用，根本无法释放底层持有的文件资源或重置全局Logger。

解决方案 #

方案1：懒加载复用全局日志配置（推荐）

将日志初始化逻辑改为仅首次调用时执行，后续调用直接复用已配置的全局Logger，从根源避免二次初始化panic和文件重复锁定问题：

use once_cell::sync::OnceCell;
use log::LevelFilter;
use log4rs::{config::{Appender, Config, Root}, append::rolling_file::RollingFileAppender, encode::pattern::PatternEncoder};

// 用OnceCell确保日志配置只初始化一次
static LOG_INIT: OnceCell<()> = OnceCell::new();

fn configure_logging() -> Result<(), Box<dyn std::error::Error>> {
    LOG_INIT.get_or_try_init(|| {
        // 构造RollingFileAppender
        let rolling_appender = RollingFileAppender::builder()
            .encoder(Box::new(PatternEncoder::new("{d} [{t}] {l} - {m}\n")))
            .build(
                "logs/app.log",
                Box::new(/* 这里传入你的滚动策略，比如CompoundPolicy */)
            )?;

        // 构造日志配置
        let config = Config::builder()
            .appender(Appender::builder().build("rolling", Box::new(rolling_appender)))
            .build(Root::builder().appender("rolling").build(LevelFilter::Info))?;

        // 初始化全局Logger
        log4rs::init_config(config)?;
        Ok(())
    })?;
    Ok(())
}

方案2：手动管理局部Logger实例

如果必须每次调用都使用独立的日志配置（比如每次调用输出到不同文件），则放弃全局初始化，改用局部Logger实例，调用结束后自动释放资源：

use log::{Log, Record, Level};
use log4rs::{load_config, config::{Config, Appender, Root}, append::rolling_file::RollingFileAppender};

fn rust_function() -> Result<(), Box<dyn std::error::Error>> {
    // 构造本次调用的日志配置
    let rolling_appender = RollingFileAppender::builder()
        .encoder(Box::new(/* 你的编码器 */))
        .build(
            format!("logs/app_{}.log", uuid::Uuid::new_v4()), // 每次调用生成唯一日志文件
            Box::new(/* 滚动策略 */)
        )?;

    let config = Config::builder()
        .appender(Appender::builder().build("rolling", Box::new(rolling_appender)))
        .build(Root::builder().appender("rolling").build(Level::Info))?;

    // 创建局部Logger实例
    let logger = load_config(config)?;

    // 手动调用Logger的log方法输出日志（不能用log宏，比如info!）
    logger.log(&Record::builder()
        .level(Level::Info)
        .target("rust_module")
        .args(format_args!("本次调用日志内容"))
        .build());

    // 函数结束时，logger被自动drop，释放文件资源
    Ok(())
}

如果想继续使用log宏，可以结合unsafe的log::set_boxed_logger替换全局Logger，但需严格保证线程安全（确保切换时无其他线程在输出日志）：

use log::SetLoggerError;

unsafe fn replace_global_logger(logger: Box<dyn Log>) -> Result<(), SetLoggerError> {
    log::set_boxed_logger(logger)
}

fn rust_function() -> Result<(), Box<dyn std::error::Error>> {
    let config = /* 构造配置 */;
    let logger = load_config(config)?;

    // 替换全局Logger，unsafe操作需确保线程安全
    unsafe {
        replace_global_logger(Box::new(logger))?;
    }

    // 现在可以正常使用log宏
    info!("用宏输出日志");
    Ok(())
}

补充：解决文件共享冲突

如果需要允许其他进程编辑日志文件，在创建RollingFileAppender时配置OpenOptions，调整文件共享权限（针对Windows系统）：

use std::fs::OpenOptions;

let rolling_appender = RollingFileAppender::builder()
    .encoder(Box::new(/* 编码器 */))
    .open_options(OpenOptions::new()
        .write(true)
        .create(true)
        .append(true)
        .share_mode(0o777)) // Windows下设置共享模式，允许其他进程读写
    .build(
        "logs/app.log",
        Box::new(/* 滚动策略 */)
    )?;

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