基于Boost.Python开发Python3.8 C++扩展的未定义符号与链接错误

错误1：导入模块时报undefined symbol: _ZTVN10__cxxabiv120__si_class_type_infoE #

这个符号属于C运行时异常处理层的标准类型信息结构，出现未定义的核心原因是*扩展模块打包时没有正确链接C标准运行时*：

• 构建流程默认调用C链接器完成最终的动态库打包，没有加载libstdc++的相关符号
• 编译选项和本地Python解释器、Boost.Python库的C++ ABI不兼容，比如一方开启了RTTI/异常支持，另一方关闭了相关特性

错误2：手动执行g++编译时报大量链接错误 #

直接执行g++ -I /usr/include/python3.8 pyobj.cpp出现的报错可以拆成三类逐一对应原因：

• undefined reference to 'main'：手动编译时默认生成静态可执行程序，而Python扩展模块是位置无关的动态共享库，本身不需要main入口函数。编译时必须显式指定-fPIC（生成位置无关代码）、-shared（生成动态共享库）标记，才能匹配Python扩展的格式要求。
• Boost.Python相关的未定义引用（比如boost::python::detail::init_module、类的虚表、typeinfo等）：链接时没有加入本地安装的Boost.Python动态库，编译流程找不到对应的库实现。
• Python C API相关的未定义引用（比如PyLong_FromLong、_Py_Dealloc、_Py_NoneStruct等）：链接时没有加载Python开发库，无法解析Python解释器暴露的C接口符号。

可直接复用的正确构建配置 #

修正后需要在原setup.py的Extension定义中补充编译、链接相关的必要配置，同时保证模块名和BOOST_PYTHON_MODULE宏定义一致：

from distutils.core import setup, Extension

example_module = Extension(
    # 模块名必须和BOOST_PYTHON_MODULE定义的名字完全一致
    'pyobj',
    sources=['pyobject.cpp'],
    language='c++',
    extra_compile_args=['-fPIC'],
    # 指定需要链接的依赖库
    libraries=[
        'boost_python38',  # 对应Python3.8版本的Boost.Python库，根据本地包名调整
        'python3.8'
    ],
    extra_link_args=['-shared']
)

setup(
    name='pyobj',
    version='0.1.0',
    description='example module written in C++',
    ext_modules=[example_module],
)

额外排查注意点 #

• 保证C++代码中BOOST_PYTHON_MODULE宏传入的模块名，和Extension定义的输出模块名完全一致——宏会自动生成对应名字的模块初始化入口函数，名字不匹配时Python会直接报模块找不到的错误。
• 安装Boost.Python时要严格匹配当前使用的Python版本，错装Python2版本的Boost.Python库会直接导致全量符号不匹配。
• 编译时不要擅自添加-fno-exceptions、-fno-rtti这类关闭C++核心特性的编译标记，会和Boost.Python的编译配置产生ABI不兼容。
• 如果系统安装了多个Python版本，要保证构建时调用的Python解释器、对应的开发库、Boost.Python库三者的版本完全统一，避免交叉链接不同版本的运行时。

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