使用Boost.Python创建模块时遭遇LNK2019链接错误求助

错误原因分析 #

你遇到的LNK2019错误，本质是链接器无法找到Boost.Python库中的throw_error_already_set符号，核心问题是Boost编译时依赖的Python版本与CMake项目中检测到的Python版本不匹配，或者CMake错误地尝试链接Python2版本的Boost.Python库（python组件名默认对应Python2，Python3对应的组件为python3或带版本号的python3x）。

具体解决步骤 #

1. 重新编译Boost.Python，明确指定Python版本与路径 #

Boost默认会自动检测系统Python，但可能和项目使用的版本不一致，需手动指定参数编译：

b2 --with-python address-model=64 toolset=msvc --build-dir=build link=shared python=3.10 python-path=C:/Python310 install stage

• 将python=3.10替换为你实际使用的Python版本（如3.9、3.11）
• python-path填写你的Python安装根目录，确保路径准确

2. 修改CMake配置，匹配Python3版本的Boost组件 #

修改CMake文件，让Boost组件与Python版本严格对应：

cmake_minimum_required(VERSION 3.12)
project(my_project)

find_package(Python REQUIRED COMPONENTS Development)

message("found python, version = ${Python_VERSION}")
message("found python, version_major = ${Python_VERSION_MAJOR}")
message("found python, version_minor = ${Python_VERSION_MINOR}")

# 根据Python版本生成对应Boost组件名（如Python3.10对应python310）
set(BOOST_PYTHON_COMPONENT "python${Python_VERSION_MAJOR}${Python_VERSION_MINOR}")
find_package(Boost COMPONENTS ${BOOST_PYTHON_COMPONENT} REQUIRED)

message("Boost Dir: ${Boost_DIR}")
message("Boost Found: ${Boost_FOUND}")
message("Boost Include Dir: ${Boost_INCLUDE_DIR}")
message("Boost Libraries: ${Boost_LIBRARIES}")

# 模块名称需与BOOST_PYTHON_MODULE定义一致
add_library(my_module MODULE my_module.cpp wrap.cpp)

target_include_directories(my_module PRIVATE ${Python_INCLUDE_DIRS})
target_link_libraries(my_module PRIVATE ${Python_LIBRARIES})

# 链接对应版本的Boost.Python库
target_link_libraries(my_module PRIVATE Boost::${BOOST_PYTHON_COMPONENT})

3. 修正BOOST_PYTHON_MODULE的名称 #

Windows下Python扩展模块的名称必须与输出的.pyd文件名一致，修改wrap.cpp中的模块定义：

#include <iostream>
#include <boost/python.hpp>
#include "my_module.h"

using namespace boost::python;

// 名称需与CMake中add_library的模块名一致
BOOST_PYTHON_MODULE(my_module)
{
    class_<Some>( "Some" )
        .def( init<int,string>( args( "some_id", "name" ) ) )
        .def( "ID", &Some::ID )
        .def( "Name", &Some::Name, return_value_policy<copy_const_reference>() )
        .def( "ResetID", static_cast< void (Some::*)() >( &Some::ResetID ) )
        .def( "ResetID", static_cast< void (Some::*)(int) >( &Some::ResetID ), args( "some_id" ) )
        .def( "ChangeName", &Some::ChangeName, args( "name" ) )
        .def( "SomeChanges", &Some::SomeChanges, args( "some_id", "name" ) );
}

4. 验证依赖一致性 #

编译前确认：

• Boost编译时指定的Python版本与CMake检测到的版本完全一致
• Boost的stage/lib目录下存在对应版本的库文件（如boost_python310-vc143-mt-x64-1_82.lib，版本号、工具集需匹配你的环境）

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