Rust函数返回值无法引用本地/临时变量的排查与解决求助

问题描述 #

我在实现一个递归函数时遇到问题，该函数用于遍历目录及其子目录，收集路径与Axum MethodRouter组成的向量。编译器报错：cannot return value referencing local variable 'path'；若将path.to_str()替换为path.clone().to_str()，则报错变为cannot return value referencing temporary value。

代码示例 #

fn assign_handlers(dir: Option<&str>) -> Vec<(&str, MethodRouter)> {
    //Check root dir validity
    let dir = match dir {
        Some(s) => s,
        None => return vec![],
    };

    //Look for routes in dir
    let dir_path = fs::read_dir(dir).expect(&format!("Unable to access directory '{}'", &dir));
    let mut routes = Vec::new();
    for entry in dir_path {
        match entry {
            Ok(entry) => {
                let path = entry.path();
                if path.is_dir() {
                    //Recurse into subdirectories
                    let subroutes = assign_handlers(path.to_str());
                    for route in subroutes {
                        routes.push(route)
                    }
                } else if path.is_file() {
                    // Cut for brevity (and because I don't know what goes here yet)
                }
            },
            Err(_) => {},
        }
    }

    routes
}

问题成因 #

• path.to_str()返回的&str是对局部变量path（PathBuf类型）的引用，递归调用结束后path会被销毁，导致返回的引用悬空，违反Rust的生命周期规则。
• path.clone().to_str()虽然克隆了PathBuf，但克隆出的是临时值，调用assign_handlers后临时值就会被释放，同样会造成引用悬空。

解决方法 #

核心思路是用拥有所有权的字符串替代引用，让路径字符串的生命周期独立于局部变量，避免悬空引用。

修改后的代码 #

use axum::routing::MethodRouter;
use std::fs;

fn assign_handlers(dir: Option<&str>) -> Vec<(String, MethodRouter)> {
    // 检查根目录有效性
    let dir = match dir {
        Some(s) => s,
        None => return vec![],
    };

    // 遍历目录中的路由
    let dir_path = fs::read_dir(dir).expect(&format!("无法访问目录 '{}'", dir));
    let mut routes = Vec::new();
    for entry in dir_path {
        match entry {
            Ok(entry) => {
                let path = entry.path();
                if path.is_dir() {
                    // 将路径转为String，确保所有权被持有
                    let sub_dir = path.to_str().expect("路径包含无效UTF-8字符").to_string();
                    let subroutes = assign_handlers(Some(&sub_dir));
                    routes.extend(subroutes);
                } else if path.is_file() {
                    // 此处添加文件处理逻辑，比如生成对应的MethodRouter
                    // 示例：
                    // let router = MethodRouter::new();
                    // routes.push((path.to_str().expect("无效UTF-8路径").to_string(), router));
                }
            },
            Err(e) => eprintln!("读取目录条目失败: {}", e),
        }
    }

    routes
}

关键修改点 #

1. 返回类型调整：将Vec<(&str, MethodRouter)>改为Vec<(String, MethodRouter)>，用String（拥有所有权）替代&str（引用）。
2. 路径所有权处理：将子目录路径转为String后再传入递归函数，确保字符串的生命周期覆盖整个递归调用过程。
3. 错误处理优化：添加了目录读取错误的打印，便于调试。

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