从源码编译Boost后CMake识别Python版本异常的排查与解决

问题背景 #

在Ubuntu 18.04 LTS Docker镜像中，因apt无法获取最新版本Boost，需从源码编译。但出现以下异常：

• 当BUILD_BOOST_FROM_SOURCE=1（源码编译Boost）时，CMake错误识别Python2.7：

#5 563.5 -- Found Boost: /usr/local/include (found version "1.65.1")  
#5 564.1 -- Found Python: /usr/bin/python2.7 (found version "2.7.17") found components: Interpreter Development Development.Module Development.Embed 

• 当通过apt-get install libboost-all-dev安装Boost时，CMake能正确识别系统的Python3.6：

#5 88.70 -- Found Boost: /usr/include (found version "1.65.1")  
#5 89.16 -- Found Python: /usr/bin/python3.6 (found version "3.6.9") found components: Interpreter Development Development.Module Development.Embed 

已尝试的无效操作：

• 将源码编译的Boost版本调整为与apt安装的一致（1.65.1），问题依旧
• 调整安装顺序
• 给bootstrap.sh传递--with-python=/usr/bin/python3参数
• 排查发现：源码编译Boost后，CMake无法找到/usr/include/python3.6m/Python.h，但apt安装Boost时该文件可被正常识别

解决方案 #

1. 确保Python3开发依赖完整安装 #

在编译Boost前，先安装Python3的开发包，保证头文件和库文件存在：

apt-get update && apt-get install -y --no-install-recommends python3-dev python3-pip

2. 源码编译Boost时精准指定Python3参数 #

仅传递--with-python不足以让Boost正确关联Python3，需明确指定头文件、库路径和版本：

步骤1：获取Python3的关键路径

# 获取Python3头文件路径
PYTHON3_INCLUDE=$(python3 -c "import sysconfig; print(sysconfig.get_path('include'))")
# 获取Python3库文件路径
PYTHON3_LIB=$(python3 -c "import sysconfig; print(sysconfig.get_config_var('LIBDIR'))")
# 获取Python3版本（如3.6）
PYTHON3_VERSION=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')")

步骤2：运行bootstrap.sh并指定完整参数

./bootstrap.sh \
  --prefix=/usr/local \
  --with-python=/usr/bin/python3 \
  --with-python-root=/usr

步骤3：编译并安装Boost

直接通过b2传递Python相关参数，避免配置文件错误：

./b2 install \
  --with-python \
  python-include=${PYTHON3_INCLUDE} \
  python-lib=${PYTHON3_LIB}/libpython${PYTHON3_VERSION}m.so \
  threading=multi \
  link=shared \
  -j$(nproc)

3. CMake层面强制优先查找Python3 #

在项目的CMakeLists.txt中，明确指定查找Python3而非默认的Python，避免CMake fallback到Python2：

# 强制查找Python3的指定组件
find_package(Python3 REQUIRED COMPONENTS Interpreter Development Development.Module Development.Embed)

# 可选：手动指定Python3头文件路径，确保CMake能找到Python.h
set(CMAKE_PREFIX_PATH "${PYTHON3_INCLUDE}" ${CMAKE_PREFIX_PATH})

4. Dockerfile中的额外注意事项 #

• 编译Boost前必须完成Python3-dev的安装，不可颠倒顺序
• 每次编译Boost前，清理源码目录下的缓存文件（如bin.v2文件夹），避免旧配置干扰：

rm -rf bin.v2

• 设置环境变量确保Python3优先：

export PATH="/usr/bin/python3:$PATH"
export PYTHONPATH="/usr/lib/python3.6/site-packages:$PYTHONPATH"

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