C++中用Python.h导入signals模块失败，Numpy报未定义符号错误

1. 确保Python全局初始化在主线程完成 #

不管my_function的调用线程是什么，必须在主线程执行一次Py_Initialize()，不能把初始化逻辑放在my_function内部。子线程调用Python代码前，必须先获取GIL（全局解释器锁），用完后释放：

// 主线程入口处执行（比如程序启动时）
Py_Initialize();
// 可选：添加模块搜索路径，确保能找到numpy
PyRun_SimpleString("import sys; sys.path.insert(0, '/your/python/site-packages/path')");

// my_function内部逻辑
void my_function() {
    PyGILState_STATE gstate = PyGILState_Ensure();
    // 执行Python操作，比如导入signals
    PyObject* signals_mod = PyImport_ImportModule("signals");
    if (!signals_mod) {
        PyErr_Print();
    }
    PyGILState_Release(gstate);
}

2. 校验Python与Numpy版本兼容性 #

确认你C++链接的Python库版本，和系统中安装的Numpy依赖的Python版本完全一致。比如链接Python 3.8，就安装适配3.8的Numpy版本，版本不匹配会导致符号缺失。

3. 显式链接Python动态库（Linux/macOS） #

编译C程序时，必须显式链接Python动态库，避免静态链接导致符号未导出。以g为例：

g++ your_code.cpp -o your_program -I/usr/include/python3.x -lpython3.x

用CMake的话，要正确关联Python开发库：

find_package(Python3 REQUIRED COMPONENTS Development)
target_link_libraries(your_program PRIVATE Python3::Python)

4. 检测my_function的调用线程 #

如果不确定线程环境，在函数内添加线程检测逻辑（C++11及以上）：

#include <thread>
void my_function() {
    static std::thread::id main_thread_id = std::this_thread::get_id();
    if (std::this_thread::get_id() != main_thread_id) {
        // 子线程调用，必须严格处理GIL
        PyGILState_STATE gstate = PyGILState_Ensure();
        // 执行Python操作
        PyGILState_Release(gstate);
    } else {
        // 主线程直接执行
        // ...
    }
}

5. 排查Python初始化完整性 #

确保Py_Initialize()只调用一次，且没有提前执行Py_Finalize()。重复初始化或提前销毁Python环境，会导致内部符号表被清理，引发未定义符号错误。

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