You need to enable JavaScript to run this app. C++嵌入Python使用Python/C API时无法向Python函数传参的问题排查
优惠活动
大模型
产品
解决方案
定价
更多

C++嵌入Python使用Python/C API时无法向Python函数传参的问题排查

C++通过Python/C API调用Python带参方法的问题排查

场景说明

C++工程内嵌Python模块运行时,需要跨语言调用目标类实例的get_list方法,该Python方法签名为:

def get_list(self, num_units, max_time):

方法要求入参为1个无符号整数、1个双精度浮点数,返回列表类型结果。

最初的错误实现

最早的调用代码运行时,Python端在get_list内部添加的打印调试日志完全不触发,参数根本没有传入函数:

unsigned int num_units = 10;
double max_time = 15.12;
PyObject *output_list = PyObject_CallMethod(sample_object, "get_list", 
                                            "(I)", num_units, "(d)", max_time);

问题根因

  • 上述代码的格式串写法完全不符合Python/C API对PyObject_CallMethod的参数格式约定:格式串里的圆括号用于标记嵌套元组结构,"(I), (d)"的写法会让API认为需要传递两个独立的、被元组包裹的参数,和目标函数要求的两个平铺参数语义完全不匹配,参数校验失败直接中断调用,Python方法自然无法被触发执行。
  • 排查过程中一度误以为修正格式后的调用也不生效,实际是Python侧代码本身存在未被捕获的语法问题,加上调用链路没有完善的错误检查逻辑,错误信息被静默掩盖,误以为修正后的调用语法存在问题。

经验证可正常运行的实现

方式1:使用带格式串的PyObject_CallMethod

去掉格式串里的多余括号,按照参数顺序平铺标记类型即可:

PyObject *output_list = PyObject_CallMethod(sample_object, "get_list",
                                            "Id", num_units, max_time);

其中格式串"Id"的语义为:两个平铺入参,第一个对应无符号整型,第二个对应双精度浮点数,完全匹配Python函数的参数要求。

方式2:使用PyObject_CallMethodObjArgs直接传入PyObject对象

手动构造每个参数对应的Python对象,不需要依赖格式串解析,适合参数结构复杂的调用场景:

PyObject *func_obj, *num_units_obj, *max_time_obj;

num_units_obj = PyLong_FromUnsignedLong(num_units);
max_time_obj = PyFloat_FromDouble(max_time);
func_obj = PyUnicode_FromString("get_list");

// 参数列表必须以NULL作为结束标记
PyObject *output_list = PyObject_CallMethodObjArgs(sample_object, 
                                                   func_obj, num_units_obj,
                                                   max_time_obj, NULL);

// 手动构造的对象需要主动递减引用计数,避免内存泄漏
Py_DECREF(func_obj);
Py_DECREF(num_units_obj);
Py_DECREF(max_time_obj);

通用注意事项

  • 跨语言调用链路必须增加错误检查逻辑:调用API后通过PyErr_Occurred()判断是否存在异常,通过PyErr_Print()打印完整报错信息,避免Python侧语法错误、参数不匹配等问题被静默吞掉,大幅增加排查成本。
  • Python/C API的PyObject_CallMethod格式串语义和Python原生字符串格式化规则存在差异,编写时不要随意嵌套括号,保证类型标记顺序和实际入参顺序完全对齐。
  • 使用PyObject_CallMethodObjArgs时,传入的参数列表必须以NULL作为结束标记;手动通过PyLong_FromUnsignedLong、PyFloat_FromDouble等接口构造的PyObject对象,需要在调用完成后主动通过Py_DECREF递减引用计数,避免内存泄漏。

内容的提问来源于stack exchange,提问作者Amir

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 15:06:07