C++嵌入Python时PyRun_AnyFile执行失败如何获取并导出错误信息到文件

问题原因 #

你之前的两种方案失效的核心原因是 PyRun_AnyFile 执行报错后，会自动调用PyErr_Print打印异常到默认stderr，然后清除全局错误状态，所以你后续调用PyErr_Fetch时已经拿不到任何有效异常对象了。

下面提供两种可行实现方案：

方案1：重定向Python的stderr到指定文件（适配现有代码，实现最简单） #

不需要修改你调用PyRun_AnyFile的核心逻辑，只需要提前替换Python的标准错误输出对象即可，所有Python运行时的报错都会自动写入你指定的日志文件。

#include <Python.h>

int main() {
    Py_Initialize();

    // 提前重定向sys.stderr到指定日志文件
    PyObject* sysModule = PyImport_ImportModule("sys");
    PyObject* stderrFile = PyObject_CallMethod(sysModule, "open", "ss", 
        "C:\\py_error.log", // 替换为你的错误日志路径
        "a" // 写入模式：a为追加，w为覆盖
    );
    PyObject_SetAttrString(sysModule, "stderr", stderrFile);
    Py_DECREF(sysModule);
    Py_DECREF(stderrFile);

    // 你的原有执行逻辑
    const char pFile[] = "C:\\testing.py";
    FILE* fp = _Py_fopen(pFile, "r");
    int ret = PyRun_AnyFile(fp, pFile);
    if (fp) fclose(fp);

    // 可选：执行完成后恢复原始stderr，避免影响后续Python逻辑
    // PyObject* originalStderr = PySys_GetObject("stderr"); // 建议重定向前提前保存原始对象
    // sysModule = PyImport_ImportModule("sys");
    // PyObject_SetAttrString(sysModule, "stderr", originalStderr);

    Py_Finalize();
    return 0;
}

方案2：手动捕获异常并格式化完整Traceback（适合需要把错误内容读到C++字符串处理的场景） #

替换PyRun_AnyFile为更底层的执行API，避免系统自动清除异常状态，手动调用Python的traceback模块格式化完整错误栈，你可以自由处理拿到的错误字符串。

#include <Python.h>
#include <iostream>
#include <string>

int main() {
    Py_Initialize();

    const char pFile[] = "C:\\testing.py";
    FILE* fp = _Py_fopen(pFile, "r");
    int ret = 0;

    if (fp) {
        PyObject* module = PyImport_AddModule("__main__");
        PyObject* globalDict = PyModule_GetDict(module);
        // 用PyRun_FileExFlags代替PyRun_AnyFile，不自动处理异常
        PyObject* result = PyRun_FileExFlags(fp, pFile, Py_file_input, 
            globalDict, globalDict, 0, NULL);

        if (!result) {
            // 此时错误状态未被清除，可以正常获取
            PyObject *ptype, *pvalue, *ptraceback;
            PyErr_Fetch(&ptype, &pvalue, &ptraceback);
            PyErr_NormalizeException(&ptype, &pvalue, &ptraceback);

            // 调用traceback模块格式化完整错误栈
            PyObject* tracebackModule = PyImport_ImportModule("traceback");
            PyObject* formatFunc = PyObject_GetAttrString(tracebackModule, "format_exception");
            PyObject* args = PyTuple_Pack(3, ptype, pvalue, ptraceback ? ptraceback : Py_None);
            PyObject* resultList = PyObject_CallObject(formatFunc, args);

            // 拼接成C++字符串，可自由写入自定义日志、输出到控制台等
            std::string errorStr;
            for (Py_ssize_t i = 0; i < PyList_Size(resultList); i++) {
                const char* lineStr = PyUnicode_AsUTF8(PyList_GetItem(resultList, i));
                errorStr += lineStr;
            }
            std::cout << "捕获到Python错误：\n" << errorStr << std::endl;

            // 释放资源，避免内存泄漏
            Py_DECREF(formatFunc);
            Py_DECREF(tracebackModule);
            Py_DECREF(args);
            Py_DECREF(resultList);
            Py_XDECREF(ptype);
            Py_XDECREF(pvalue);
            Py_XDECREF(ptraceback);

            ret = -1;
        } else {
            Py_DECREF(result);
            ret = 0;
        }
        fclose(fp);
    }

    Py_Finalize();
    return 0;
}

注意事项 #

• 方案1属于全局修改，多线程环境下需要避免同时修改stderr产生冲突
• 所有Python C API返回的PyObject对象都需要注意正确管理引用计数，避免内存泄漏

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