如何检测Python脚本调用的Boost.Python C++代码内存泄漏

针对你用Boost.Python封装C++类并在Python中调用的场景，这里有几个实用且高效的内存泄漏检测方案，按推荐程度排序：

1. 使用AddressSanitizer（ASAN）—— 首选，速度快且精准 #

ASAN是Google开发的内存错误检测工具，比传统的Valgrind快得多，还能直接给出详细的泄漏栈跟踪，定位问题效率极高。

操作步骤： #

• 编译C++共享库时添加ASAN编译选项，同时保留调试信息：

  g++ -shared -fPIC -g -fsanitize=address -I/usr/include/python3.x -lboost_python3 your_code.cpp -o test.so
  

  （替换python3.x为你的实际Python版本，比如python3.8或python3.10）
• 运行Python脚本时启用泄漏检测：

  ASAN_OPTIONS=detect_leaks=1 python your_script.py
  

如果你的C++代码存在泄漏（比如示例中Test类构造函数分配了内存但未释放），ASAN会直接输出泄漏的内存地址、分配时的完整调用栈，甚至能定位到具体代码行，非常直观。

2. 使用Valgrind Memcheck—— 兼容性拉满的经典工具 #

Valgrind是Linux下老牌的内存检测工具，兼容性极好，几乎能适配所有C++代码场景，唯一的小缺点是运行速度较慢，适合小型项目或对兼容性要求高的场景。

操作步骤： #

• 编译C++代码时添加调试选项-g，方便后续定位泄漏代码行：

  g++ -shared -fPIC -g -I/usr/include/python3.x -lboost_python3 your_code.cpp -o test.so
  

• 用Valgrind运行Python脚本，同时屏蔽Python自身的内存泄漏报告（Python的GC机制会保留一些正常的未释放内存，无需关注）：

  valgrind --leak-check=full --suppressions=python.supp python your_script.py
  

  你可以从系统默认路径找到python.supp文件（通常在/usr/lib/python3.x/config-3.x-x86_64-linux-gnu/目录下），也可以自己编写过滤规则。

Valgrind会生成详细的泄漏报告，区分"definitely lost"（明确泄漏）、"indirectly lost"等类型，你只需聚焦在C++代码相关的条目即可。

3. 自定义内存跟踪—— 精细控制的场景方案 #

如果需要针对特定模块或类进行精细化内存跟踪，你可以在C++代码中重载new/delete运算符，或者使用自定义内存分配器记录所有内存操作。

示例代码： #

#include <boost/python.hpp>
#include <map>
#include <iostream>

namespace bpl = boost::python;

// 全局内存跟踪容器，记录分配地址和代码位置
std::map<void*, std::string> allocated_memory;

// 重载new运算符，记录分配位置
void* operator new(size_t size, const char* file, int line) {
    void* ptr = std::malloc(size);
    allocated_memory[ptr] = std::string(file) + ":" + std::to_string(line);
    return ptr;
}

#define new new(__FILE__, __LINE__)

// 重载delete运算符，移除已释放的记录
void operator delete(void* ptr) noexcept {
    allocated_memory.erase(ptr);
    std::free(ptr);
}

class Test {
public:
    Test() : data(new int(42)) {} // 模拟动态内存分配
    // 故意不写析构函数，制造内存泄漏
private:
    int* data;
};

// 程序退出前检查未释放的内存
void check_leaks() {
    if (!allocated_memory.empty()) {
        std::cerr << "Memory leaks detected:\n";
        for (const auto& pair : allocated_memory) {
            std::cerr << "  Address: " << pair.first << " allocated at: " << pair.second << "\n";
        }
    }
}

BOOST_PYTHON_MODULE(Test) {
    bpl::class_<Test>("Test", bpl::init<>());
    // 注册检查函数，供Python调用
    bpl::def("check_leaks", &check_leaks);
}

对应的Python脚本：

import test
import gc

t = test.Test()
# 手动触发GC，模拟对象被回收
gc.collect()
# 调用C++的泄漏检查函数
test.check_leaks()

这种方法适合需要针对性跟踪特定组件内存情况的场景，但需要侵入C++代码实现。

额外注意：Boost.Python的内存管理逻辑 #

Boost.Python默认会接管C对象的生命周期：当Python中的引用被回收（比如t变量被删除或GC），Boost.Python会自动调用C对象的析构函数。但如果你的C++类内部有手动管理的裸指针、动态分配的内存，一定要确保在析构函数中释放，否则即使对象被正确销毁，内部内存仍然会泄漏。

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