Python类属性通过pybind11返回空numpy数组问题求助

问题现象 #

把whispercpp的pybind11绑定项目CI里的Python版本从3.8升到3.9及以上（比如3.11.8）后，Wavfile（对应C++的WavFileWrapper）类的mono属性返回空numpy数组，但底层的WAV读取函数明明能正常读出数据——直接返回std::vector<float>类型的音频样本是完全没问题的。

问题原因 #

1. 返回值策略用错了：load_wav_file函数是在栈上构造WavFileWrapper对象然后返回，但pybind11注册这个函数时用了py::return_value_policy::reference。这个策略是告诉pybind11“返回C对象的引用，所有权还是C的”，但栈上的对象在函数结束后直接销毁了，Python拿到的就是个空架子（悬垂引用）。3.8版本的Python可能没立刻回收这块内存，所以还能读到数据；3.9+的内存管理更严格，直接就把数据清了。
2. 数组和对象的生命周期没绑在一起：原来的WavFileWrapper里mono是py::array_t<float>类型，它的数据是靠独立的pybind11胶囊管理的。当Wrapper对象因为悬垂引用被销毁时，胶囊的存活得不到保证，3.9+下会提前释放内存，数组自然就空了。

修复方案 #

核心改两点 #

一是把返回值策略改成让pybind11接管Wrapper对象的所有权，二是让mono的数据生命周期和Wrapper绑在一起。

具体代码改动 #

1. 改api_cpp2py_export.h里的WavFileWrapper定义

把mono的类型从py::array_t<float>改成std::vector<float>，构造函数里用move减少拷贝：

struct WavFileWrapper {
    std::vector<float> mono;
    std::vector<std::vector<float>> stereo;

    WavFileWrapper(std::vector<float> *mono,
                   std::vector<std::vector<float>> *stereo)
        : mono(std::move(*mono)), stereo(std::move(*stereo)){};

    static WavFileWrapper load_wav_file(const char *filename);
};

2. 改api_cpp2py_export.cpp里的pybind注册代码

• 给load_wav_file换返回值策略为take_ownership，让Python管Wrapper的生命周期；
• 给mono属性加个lambda，访问时把vector转成numpy数组，同时让Python接管数组的所有权：

// 修正load_wav_file的返回值策略
m.def("load_wav_file", &WavFileWrapper::load_wav_file, "filename"_a,
      py::return_value_policy::take_ownership);

py::class_<WavFileWrapper>(m, "Wavfile",
                           "A light wrapper for the processed wav file.")
    .def_property_readonly(
        "stereo", [](WavFileWrapper &self) { return self.stereo; },
        py::return_value_policy::copy)
    .def_property_readonly(
        "mono", [](WavFileWrapper &self) { 
            return whisper::as_pyarray(std::move(self.mono)); 
        },
        py::return_value_policy::take_ownership);

3. as_pyarray函数不用改

这个函数负责把vector零拷贝转成numpy数组，还靠胶囊管内存，确保Python能正确释放数据，留着就行。

临时修复说明 #

已经通过把WavFileWrapper的mono成员改成std::vector<float>，访问时再转成numpy数组的方式解决了问题，同时调整了返回值策略保证对象生命周期正常。

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