使用boost.python为第三方C++动态库生成Python绑定时导入报错

可以直接通过boost.python生成持有头文件和动态库的第三方C++ API的Python绑定，你当前的实现思路本身没问题，导入报错是编译、配置环节的错误导致的。

你遇到的undefined symbol错误是Boost.Python符号未被正确链接到生成的扩展库导致的，具体有以下几个错误点：

• 版本不匹配：你引用了Python3.8的头文件，但链接的是适配Python3.9的boost_python39库，两者ABI不兼容
• 模块名不匹配：BOOST_PYTHON_MODULE中声明的模块名是bb_api，但你生成的扩展库文件名是tp_api前缀，Python导入时无法匹配模块初始化函数
• 编译命令语法错误：
  • 多余的-undefined参数，Linux下该参数需要后跟符号名，无对应参数时会导致链接逻辑异常
  • python3-config --extension-suffix未被反引号/$()包裹，shell不会将其解析为命令执行，无法生成正确的扩展文件名
  • 未链接第三方API对应的动态库，也没有将bind.cc源文件放在链接参数的前面，导致链接器无法正确解析符号
• 缺少运行时库路径配置：未把第三方动态库、Boost.Python动态库的路径加入系统动态库搜索路径，导入时无法找到依赖

1. 修正绑定文件中的模块名，和输出的扩展库前缀保持一致：

#include <boost/python/module.hpp>
#include <boost/python/def.hpp>
#include "tp_api.h"
BOOST_PYTHON_MODULE(tp_api) // 这里从bb_api改成tp_api
{
  using namespace boost::python;
  def("tpGetAPIVersion", tpGetAPIVersion);
}

2. 调整编译命令，修正所有语法和参数错误（假设你的第三方库文件名为libtp_api.so，放在./third_party/lib路径下，头文件在./third_party/include下，可根据你的实际路径修改）：

g++ -O3 -Wall -shared -std=c++11 -fPIC \
-I/usr/include/python3.8 \
-I/usr/local/include \
-I./third_party/include \
-L/usr/local/lib \
-L./third_party/lib \
bind.cc \
-lboost_python38 \
-ltp_api \
-o tp_api$(python3.8-config --extension-suffix)

3. 配置运行时动态库路径，执行Python导入前先运行：

export LD_LIBRARY_PATH=/usr/local/lib:./third_party/lib:$LD_LIBRARY_PATH

完成上述步骤后，执行以下Python代码即可正常调用：

from tp_api import tpGetAPIVersion
print(tpGetAPIVersion())

内容的提问来源于stack exchange，提问作者S.Max