如何将OpenCV cv::Mat转换为void*指针？是否有更优实现方案？

原有实现的潜在问题 #

• 手动new的裸cv::Mat指针需要开发者自行管理释放逻辑，一旦遗漏delete就会出现内存泄露，代码维护成本高
• 入参是值传递的cv::Mat本身已经触发了一次浅拷贝（引用计数+1），后续调用copyTo又做了一次全量数据拷贝，存在不必要的性能损耗

最优实现方案 #

根据第三方SDK对用户自定义元数据的生命周期管理逻辑，分两种情况选择对应方案：

情况1：SDK支持传入自定义数据销毁回调 #

这是最推荐的场景，你可以完全利用cv::Mat的引用计数机制，同时避免内存泄露：

1. 元数据指针生成代码：

void* set_metadata_ptr(const cv::Mat& frame)
{
    // 直接调用拷贝构造，仅增加引用计数，不复制底层像素数据，性能更高
    return new cv::Mat(frame);
    // 若需要深拷贝避免原数据修改影响元数据，改成 return new cv::Mat(frame.clone()); 即可
}

2. 配套的销毁回调函数：

void free_metadata(void* data)
{
    if (data != nullptr) {
        delete static_cast<cv::Mat*>(data);
    }
}

将free_metadata作为销毁回调参数传给SDK，SDK在结束使用元数据时会自动调用该函数释放内存，无需手动管理。cv::Mat被delete时会自动减少引用计数，计数归0时底层像素内存自动释放，完全符合cv::Mat的智能指针设计规范。

情况2：SDK不支持销毁回调，需要开发者自行保证数据有效期 #

可以用容器持有cv::Mat的实例，完全避免裸指针的使用：

1. 定义生命周期覆盖SDK使用周期的容器作为数据持有者：

// 可定义为全局变量、类成员变量，保证其生命周期长于SDK使用元数据的周期
std::vector<cv::Mat> meta_holder;
// 多线程场景下需要搭配互斥锁保护容器操作
std::mutex meta_mutex;

2. 元数据指针生成代码：

void* set_metadata_ptr(const cv::Mat& frame)
{
    std::lock_guard<std::mutex> lock(meta_mutex);
    meta_holder.push_back(frame);
    return static_cast<void*>(&meta_holder.back());
}

3. 确认SDK所有元数据使用完成后，清空容器释放内存：

void clear_metadata()
{
    std::lock_guard<std::mutex> lock(meta_mutex);
    meta_holder.clear();
}

这种方案完全不需要手动申请/释放堆内存，所有cv::Mat的生命周期由容器自动管理，安全性最高。

注意事项 #

• 禁止直接将cv::Mat::data指针（底层像素数据的裸指针）转为void*传给SDK，该指针不持有cv::Mat的引用，一旦原cv::Mat被释放，指针就会变为野指针，引发崩溃。
• 多线程场景下如果存在数据读写冲突，创建cv::Mat时用clone()做深拷贝即可保证数据安全。

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