Linux下用vcpkg安装soci[sqlite3]库时链接错误求助

问题场景 #

在Ubuntu 22.04环境（含Docker隔离实例）中，通过vcpkg安装soci[sqlite3]或soci[sqlite3,boost]后，按照vcpkg提示配置CMakeLists.txt，执行cmake和make时触发soci::details::parse_std_tm未定义引用错误。手动调整编译命令的库链接顺序后，程序可正常编译运行，且通过符号检查确认该函数存在于libsoci_core.a静态库中。

环境版本 #

• Ubuntu 22.04
• soci 4.0.3#1
• sqlite3 3.43.0
• vcpkg 2023-09-15

问题根源 #

GCC链接器处理静态库时，会严格按命令行顺序解析：先处理的库如果未被之前的目标文件引用，其符号会被丢弃；后续目标文件需要的符号若来自已处理过的库，就会触发未定义引用错误。本次问题中，CMake生成的编译命令将soci_core库放在了目标文件之前，导致链接器无法找到parse_std_tm符号。

解决方法 #

方法1：修正CMakeLists.txt的库链接顺序 #

调整target_link_libraries中soci组件的顺序，确保依赖其他库的组件在前，被依赖的核心库在后。

如果使用vcpkg的unofficial-soci配置：

find_package(unofficial-soci CONFIG REQUIRED)
# 先链接sqlite3组件，再链接core组件
target_link_libraries(你的项目目标 PRIVATE unofficial::soci::sqlite3 unofficial::soci::core)

如果直接使用原生SOCI配置：

find_package(SOCI REQUIRED)
target_link_libraries(你的项目目标 PRIVATE soci_sqlite3 soci_core)

修改后重新执行cmake --build .即可完成编译。

方法2：修复vcpkg的soci端口配置（可选） #

如果需要长期解决该问题，可修改vcpkg的soci端口配置，修正其CMake模块中的库依赖顺序：

1. 找到vcpkg目录下的ports/soci文件夹
2. 编辑CMakeLists.txt或对应的config文件，确保soci_sqlite3组件的链接依赖中，soci_core被放在正确的顺序位置
3. 重新运行vcpkg install soci[sqlite3]重新构建soci端口

验证步骤 #

1. 执行以下命令确认符号存在：

   nm -D libsoci_core.a | grep parse_std_tm
   

   预期输出类似：

   0000000000001234 T soci::details::parse_std_tm(std::string const&, std::tm&)
   

2. 检查CMake生成的编译命令，确认库顺序为-lsoci_sqlite3 -lsoci_core（或对应vcpkg命名的库）
3. 编译成功后运行程序，验证功能正常

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