从源码编译Python3.6.15与SQLite-3.20.1后，Python链接错误SQLite版本

一、sqlite3模块版本不符的问题排查与解决 #

1. 核心语法错误 #

你的configure命令中PKG_CONFIG_PATH的赋值存在重复定义错误：

PKG_CONFIG_PATH=PKG_CONFIG_PATH="/opt/libffi-3.4.4/lib/pkgconfig;/opt/sqlite-3.20.1/lib/pkgconfig"

重复的PKG_CONFIG_PATH=会导致环境变量未被正确设置，pkg-config无法读取到自定义sqlite3的配置文件，进而让Python编译时默认链接系统版本的sqlite3。

2. 补充编译参数以确保运行时加载自定义库 #

即使修正了PKG_CONFIG_PATH，还需要添加运行时库路径参数，避免Python运行时优先加载系统默认库：

• 在LDFLAGS中加入-Wl,-rpath=/opt/sqlite-3.20.1/lib，强制程序运行时从指定路径加载sqlite3库
• 在LDFLAGS中明确添加-lsqlite3，确保编译阶段优先链接自定义版本的库

3. 修正后的完整configure命令 #

cd Python-3.6.15
mkdir -p build && cd build
../configure \
  -C \
  --prefix=/opt/Python-3.6.15 \
  --enable-loadable-sqlite-extensions \
  --enable-optimizations \
  --with-system-ffi \
  --with-ensurepip=install \
  CC="${GCC_HOME}/bin/gcc" \
  CXX="${GCC_HOME}/bin/g++" \
  CPPFLAGS="-I/opt/sqlite-3.20.1/include" \
  LDFLAGS="-L/opt/sqlite-3.20.1/lib -Wl,-rpath=/opt/sqlite-3.20.1/lib -lsqlite3" \
  PKG_CONFIG_PATH="/opt/libffi-3.4.4/lib/pkgconfig;/opt/sqlite-3.20.1/lib/pkgconfig"
make -j8
make install

4. 验证结果 #

重新编译安装后，执行以下命令验证：

/opt/Python-3.6.15/bin/python3.6
>>> import sqlite3
>>> print(sqlite3.sqlite_version)
3.20.1

二、为何configure使用零散开关而非完全依赖pkg-config？ #

• 历史兼容需求：Python的configure脚本迭代周期长，早期pkg-config并未广泛普及，很多库的检测逻辑已通过单独参数实现，保留这些开关是为了兼容旧环境和传统编译流程。
• 库的集成特殊性：部分库（如tcltk、ffi）与Python内部逻辑耦合较深，单独的开关能更精准控制编译行为。例如--with-system-ffi明确指定使用系统提供的ffi库，避免自动检测时出现歧义。
• 跨平台适配性：不同平台对pkg-config的支持程度差异较大，使用单独参数可在无pkg-config的环境下完成编译配置，保障Python的跨平台兼容性。

内容的提问来源于stack exchange，提问作者Lance E.T. Compte