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
相关产品推荐
相关产品推荐

