PyImport_Import无法导入函数的Python嵌入开发问题排查

可能的原因及验证步骤 #

1. 模块路径或名称错误 #

你添加到sys.path的modulePath是否是目标Python文件所在的父目录？另外，name参数是否是不带.py后缀的模块名？
比如如果你的文件是test_plugin.py，那么name应该传"test_plugin"，modulePath是该文件所在的文件夹路径。如果路径不对，Python可能导入了其他同名模块（比如标准库中的模块），导致拿到的不是你写的那个模块。

验证方法：在导入模块后，打印模块的__file__属性，确认是否指向你的目标文件：

PyObject* fileAttr = PyObject_GetAttrString(module, "__file__");
if (fileAttr) {
    PyObject* bytes = PyUnicode_AsUTF8String(fileAttr);
    log("Module file: %s", PyBytes_AsString(bytes));
    Py_DECREF(bytes);
    Py_DECREF(fileAttr);
}

2. 子解释器上下文隔离导致sys.path修改未生效 #

如果你的代码运行在子解释器中，每个子解释器拥有独立的sys模块实例。如果修改sys.path的操作是在主解释器中执行的，那么子解释器的sys.path不会同步这个修改，导致导入时找不到目标模块。

解决方法：确保修改sys.path和导入模块的操作在同一个子解释器上下文中执行。比如在调用Py_NewInterpreter()后，在子解释器的线程中完成sys.path修改和模块导入。

3. 错误检查缺失掩盖了导入异常 #

你移除了错误检查代码，可能导入过程中实际发生了错误（比如权限问题、依赖缺失），但Python返回了一个空的模块对象。恢复错误检查，尤其是PyImport_Import的返回值：

PyObject* module = PyImport_Import(modName);
if (!module) {
    PyErr_Print(); // 打印具体的导入错误信息
    Py_DECREF(modName);
    return;
}

运行后查看控制台的错误输出，能直接定位问题。

4. 模块缓存或重复导入问题 #

如果之前导入过同名模块，Python可能使用了缓存的空模块。可以尝试强制重新加载模块：

// 导入后尝试重新加载
PyObject* reloadModule = PyImport_ReloadModule(module);
if (reloadModule) {
    Py_DECREF(module);
    module = reloadModule;
} else {
    PyErr_Print();
}

代码调整建议 #

恢复关键错误检查，添加模块信息验证，确保上下文正确。比如修改后的核心代码片段：

// 确保在正确的解释器上下文（子解释器/主解释器）中执行
PyObject* sysModule = PyImport_ImportModule("sys");
if (!sysModule) {
    PyErr_Print();
    return;
}

PyObject* sysPath = PyObject_GetAttrString(sysModule, "path");
PyObject* objPath = PyUnicode_FromString(modulePath.c_str());
if (PyList_Append(sysPath, objPath) == -1) {
    PyErr_Print();
}
Py_XDECREF(objPath);
Py_DECREF(sysPath);

PyObject_SetAttrString(sysModule, "dont_write_bytecode", Py_True);
Py_DECREF(sysModule);

PyObject* modName = PyUnicode_FromString(name.c_str());
PyObject* module = PyImport_Import(modName);
Py_DECREF(modName);

if (!module) {
    PyErr_Print();
    return;
}

// 验证模块信息
PyObject* modNameAttr = PyObject_GetAttrString(module, "__name__");
if (modNameAttr) {
    PyObject* bytes = PyUnicode_AsUTF8String(modNameAttr);
    log("Module name: %s", PyBytes_AsString(bytes));
    Py_DECREF(bytes);
    Py_DECREF(modNameAttr);
}

PyObject* fileAttr = PyObject_GetAttrString(module, "__file__");
if (fileAttr) {
    PyObject* bytes = PyUnicode_AsUTF8String(fileAttr);
    log("Module file: %s", PyBytes_AsString(bytes));
    Py_DECREF(bytes);
    Py_DECREF(fileAttr);
}

// 尝试直接获取test属性
PyObject* testFunc = PyObject_GetAttrString(module, "test");
if (testFunc) {
    log("Found test function!");
    if (PyCallable_Check(testFunc)) {
        log("test is callable");
    }
    Py_DECREF(testFunc);
} else {
    PyErr_Clear(); // 清除错误，避免影响后续操作
    log("test function not found");
}

// 后续遍历代码...

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