使用Boost.Python时，如何通过C API提取Python 3异常信息？

我完全理解你现在的困扰——Python 2和3的字符串模型差异确实让那些旧的方案失效了。别着急，我来给你一套适配Python 3的完整解决方案，既能获取抛出异常的类型名称，也能提取异常附带的字符串消息。

核心思路 #

Python 3中所有字符串都是Unicode类型，直接用PyBytes_AsString肯定会返回空指针（因为它只处理字节对象）。我们需要先把异常对象转换为Unicode字符串，再转成C风格的UTF-8字符串；而异常类型名称可以通过类型对象的API直接获取。

完整的异常处理代码 #

这里是替换你// ???部分的完整实现：

try {
    // 通过Boost.Python执行Python代码
} catch(boost::python::error_already_set&) {
    PyObject *ptype, *pvalue, *ptraceback;
    PyErr_Fetch(&ptype, &pvalue, &ptraceback);

    // 确保后续清理对象，避免内存泄漏
    auto cleanup = [&]() {
        Py_XDECREF(ptype);
        Py_XDECREF(pvalue);
        Py_XDECREF(ptraceback);
    };

    std::string error_type;
    std::string error_msg;

    // 获取异常类型名称
    if (ptype) {
        const char* type_name = PyType_GetName(Py_TYPE(ptype));
        if (type_name) {
            error_type = type_name;
        } else {
            error_type = "UnknownErrorType";
        }
    }

    // 获取异常消息字符串
    if (pvalue) {
        // 先获取异常对象的字符串表示（转为Unicode）
        PyObject* pstr = PyObject_Str(pvalue);
        if (pstr) {
            const char* msg = PyUnicode_AsUTF8(pstr);
            if (msg) {
                error_msg = msg;
            } else {
                error_msg = "Failed to convert error message to UTF-8";
            }
            Py_DECREF(pstr); // 释放临时字符串对象
        } else {
            error_msg = "Failed to get error message string";
        }
    }

    cleanup(); // 清理所有Python对象

    // 抛出C++异常，携带错误信息
    throw std::runtime_error(
        "Python exception occurred: [" + error_type + "] " + error_msg
    );
}

关键细节说明 #

• 内存管理：用lambda表达式cleanup确保不管流程怎么走，都能释放ptype、pvalue、ptraceback的引用，避免Python内存泄漏。Py_XDECREF比Py_DECREF更安全，因为它会处理NULL指针。
• 异常类型名称：PyType_GetName(Py_TYPE(ptype))能直接获取异常类型的名称（比如ValueError、TypeError），这个API在Python 3中是稳定的。
• 异常消息提取：PyObject_Str(pvalue)会调用Python对象的__str__方法，返回Unicode字符串对象，之后用PyUnicode_AsUTF8转成C风格的UTF-8字符串——这一步是Python 3的关键，不能直接对pvalue调用PyUnicode_AsUTF8（除非你确定pvalue本身就是Unicode对象）。

额外优化：用Boost.Python简化代码 #

如果你想更贴合Boost.Python的风格，也可以用boost::python::extract来简化部分逻辑，比如：

// 在获取pvalue之后
if (pvalue) {
    boost::python::handle<> handle_pvalue(pvalue);
    boost::python::str err_str(handle_pvalue);
    std::string error_msg = boost::python::extract<std::string>(err_str);
}

这种方式不需要手动管理临时字符串对象的引用，Boost会帮你处理。

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