Rust中包装RowIter迭代器的惯用写法及借用问题求解

我是Rust新手，还在和借用检查器打交道。我把这个问题当成通用学习机会，希望得到适用于类似场景的通用解释，而非仅针对该示例的回答。

我想要实现一个对RowIter的包装，构建一个持有RowIter的结构体，在next()和has_next()方法中添加自定义逻辑。我的包装代码如下：

use std::{fs::File, path::Path};

use parquet::{
    file::{reader::FileReader, serialized_reader::SerializedFileReader},
    record::reader::RowIter,
};

pub struct PIterator<'a> {
    row_iterator: RowIter<'a>,
}

impl<'a> PIterator<'a> {
    pub fn new(file_path: String) -> PIterator<'a> {
        let path = Path::new(&file_path);
        let file = File::open(path).unwrap();
        let reader = SerializedFileReader::new(file).unwrap();
        let row_iter = reader.get_row_iter(None);  // reader is borrowed here
        PIterator {  // cannot return value referencing local variable `reader`...
            row_iterator: row_iter.unwrap(),
        }
    }

    pub fn has_next(&self) -> bool {
        // TODO:
        false
    }

    pub fn next(&self) -> Option<String> {
        // TODO:
        None
    }
}

我理解可变引用方法调用可能导致引用悬空，需要所有权转移，但无法理解此处的‘借用者’是谁？是new方法吗？如何判断？此外，在此场景下，包装迭代器的惯用方式是什么？

一、明确谁是借用者 #

这里的“借用者”是RowIter<'a>——它内部持有对reader的引用。你可以通过两个关键点判断：

1. 生命周期绑定：RowIter的生命周期参数'a，和创建它的SerializedFileReader的生命周期是绑定的，因为get_row_iter方法的签名里，返回的RowIter依赖于&self（即对reader的引用）的存在。
2. 报错指向：编译器提示“返回值引用局部变量reader”，说明返回的PIterator里的某个成员（也就是row_iterator）拿着reader的引用，这个成员就是借用者。

为什么报错？new方法里的reader是局部变量，方法执行结束后会被销毁，但PIterator里的RowIter还保留着指向它的引用，这会造成悬空引用，这是Rust绝对禁止的。

二、包装迭代器的惯用方式 #

核心思路是保证RowIter依赖的数据源（reader）和RowIter本身生命周期一致，避免前者提前销毁。常见方案有两种：

1. 将数据源与迭代器共同存入结构体 #

既然RowIter依赖reader，就把reader也作为PIterator的成员，让两者共享生命周期：

use std::{fs::File, path::Path};

use parquet::{
    file::{reader::FileReader, serialized_reader::SerializedFileReader},
    record::reader::RowIter,
};

pub struct PIterator {
    reader: SerializedFileReader<File>,
    row_iterator: RowIter<'static>,
}

impl PIterator {
    pub fn new(file_path: String) -> Self {
        let path = Path::new(&file_path);
        let file = File::open(path).unwrap();
        let mut reader = SerializedFileReader::new(file).unwrap();
        let row_iter = reader.get_row_iter(None).unwrap();
        PIterator { reader, row_iterator: row_iter }
    }

    pub fn has_next(&self) -> bool {
        self.row_iterator.has_next()
    }

    pub fn next(&mut self) -> Option<String> {
        self.row_iterator.next().map(|row| row.to_string())
    }
}

注意：next方法需要&mut self，因为RowIter的next是可变方法，需要修改内部状态。

2. 优先使用所有权迭代器（如果场景允许） #

部分迭代器可以通过into_iter()这类方法转换为所有权迭代器，不再依赖原数据源。但RowIter必须绑定SerializedFileReader，所以这种方案不适用，但遇到其他迭代器时，优先选择持有所有权的方式，能彻底避免生命周期问题。

通用总结 #

遇到“返回值引用局部变量”的错误时：

• 先定位返回值中持有局部变量引用的成员，它就是借用者。
• 解决思路要么把被引用的变量也放进返回的结构体（绑定生命周期），要么让返回对象持有所有权而非引用。
• 包装迭代器的核心是保证迭代器和它依赖的数据源生命周期一致，最直接的方式就是将两者放在同一个结构体中。

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