WSL2 Ubuntu下C++调用DuckDB遇undefined reference链接错误求助

环境：WSL2 Ubuntu 20.04
DuckDB来源：官方下载的Linux C++二进制包
文件结构：

• ./src/main.cpp
• ./third_party/duckdb/duckdb.hpp
• ./third_party/duckdb/libduckdb.so
• ./build
• ./CMakeLists.txt

已将DuckDB路径存入环境变量DUCKDB_DIR，尝试用CMake生成Makefile编译调用Connection::Query()的简单程序。CMake成功生成文件且提示找到libduckdb.so，但执行make时链接阶段报错，核心错误信息如下：

/usr/bin/ld: CMakeFiles/column_order.dir/src/main.cpp.o: in function `main':
main.cpp:(.text+0x1c2): undefined reference to `duckdb::Connection::Query(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&)'
...
collect2: error: ld returned 1 exit status

同时尝试将main.cpp、duckdb.hpp和libduckdb.so放在同一目录，用手动编写的Makefile编译，仍出现相同错误。

相关验证信息：

• ldd libduckdb.so显示依赖的libstdc++.so.6存在且路径正常
• cmake -S ../确认DUCKDB_DIR路径正确，且成功定位到libduckdb.so
• ls $DUCKDB_DIR显示目录包含duckdb.h、duckdb.hpp、libduckdb.so、libduckdb_static.a等文件

这类未定义引用错误的核心原因是C++ ABI（应用二进制接口）不兼容：

• 你的代码用GCC 9.4编译时，默认启用了__cxx11新ABI（对应std::__cxx11::basic_string类型）
• 官方预编译的libduckdb.so可能是用不同ABI版本编译的，导致函数符号命名不匹配，链接器无法找到对应实现
• 动态库对ABI一致性要求极高，哪怕是同一款编译器，ABI编译选项不同也会导致符号无法匹配

方案1：链接静态库替代动态库 #

静态库会直接嵌入到可执行文件中，避免动态库的ABI匹配问题：

• 修改CMakeLists.txt的链接部分：

# 替换原动态库链接语句
target_link_libraries(${PROJECT_NAME} PRIVATE ${DUCKDB_DIR}/libduckdb_static.a)
# 静态库需要额外链接依赖系统库
target_link_libraries(${PROJECT_NAME} PRIVATE dl pthread)

• 如果使用手动Makefile，修改LDLIBS：

LDLIBS=libduckdb_static.a -ldl -lpthread

方案2：强制统一ABI版本 #

在编译代码时强制指定与DuckDB库一致的ABI：

• 若DuckDB库用旧ABI编译，添加编译选项-D_GLIBCXX_USE_CXX11_ABI=0：
  • CMake中添加：

  target_compile_definitions(${PROJECT_NAME} PRIVATE _GLIBCXX_USE_CXX11_ABI=0)
  

  • Makefile中修改CXXFLAGS：

  CXXFLAGS=-std=c++11 -Wall -D_GLIBCXX_USE_CXX11_ABI=0
  

• 若上述选项无效，尝试改为-D_GLIBCXX_USE_CXX11_ABI=1（对应新ABI）

方案3：源码编译DuckDB #

如果预编译库的ABI始终不匹配，直接从源码编译DuckDB，确保编译环境与项目完全一致：

1. 克隆仓库：git clone https://github.com/duckdb/duckdb.git
2. 进入目录编译动态库：cd duckdb && make BUILD_SHARED=1
3. 将编译生成的build/release/libduckdb.so和头文件替换当前第三方库文件

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