C++链接预构建faiss二进制库报错undefined reference如何解决

• 头文件可正常引入但链接报undefined reference，本质是库文件路径未正确传递给链接器、链接顺序错误、或faiss编译时的依赖（如openblas、gfortran）未同步链接
• 之前CMake配置报错的原因：find_library变量名书写错误、导入库的语法存在符号错误；rpath警告是因为系统存在多版本libz，动态库搜索路径优先级冲突
• 手动添加-L参数到CMAKE_CXX_FLAGS不生效，是因为CMAKE_CXX_FLAGS是编译阶段参数，库路径属于链接阶段参数，配置位置错误

1. 确定库选择规则 #

无特殊独立部署需求，优先选择动态库libfaiss.so，可减少二进制体积；需要打包成无外部依赖的单二进制文件时选择静态库libfaiss.a。

2. 修正ROS+catkin_simple环境下的CMake配置 #

以下配置可同时兼容动态库/静态库链接，避免之前的NOTFOUND、语法错误问题：

cmake_minimum_required(VERSION 3.10)
project(your_project_name)

# 加在project指令之后，修复rpath警告
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
# 替换为你自己的faiss库所在路径
list(APPEND CMAKE_INSTALL_RPATH "/home/tim/faiss/faiss-1_5_3/faiss-1.5.3/lib")
# 指定优先用系统路径的libz，屏蔽版本冲突警告
set(CMAKE_SYSTEM_LIBRARY_PATH "/usr/lib/x86_64-linux-gnu" ${CMAKE_SYSTEM_LIBRARY_PATH})

find_package(catkin REQUIRED COMPONENTS
  roscpp
  catkin_simple
  # 其他你的ROS依赖
)

# 配置faiss查找规则，替换FAISS_ROOT为你自己的faiss解压/安装根目录
set(FAISS_ROOT "/home/tim/faiss/faiss-1_5_3/faiss-1.5.3" CACHE PATH "Faiss root path")
find_path(FAISS_INCLUDE_DIR NAMES faiss/Index.h PATHS ${FAISS_ROOT}/include NO_DEFAULT_PATH)
# 找动态库就写NAMES faiss，找静态库就写NAMES libfaiss.a
find_library(FAISS_LIBRARY NAMES faiss PATHS ${FAISS_ROOT}/lib NO_DEFAULT_PATH)

# 校验查找结果，避免NOTFOUND错误
if(NOT FAISS_INCLUDE_DIR OR NOT FAISS_LIBRARY)
  message(FATAL_ERROR "Faiss not found! Check FAISS_ROOT path configuration")
endif()

# 导入faiss为CMake目标
add_library(faiss SHARED IMPORTED) # 用静态库就把SHARED改成STATIC
set_target_properties(faiss PROPERTIES
  IMPORTED_LOCATION ${FAISS_LIBRARY}
  INTERFACE_INCLUDE_DIRECTORIES ${FAISS_INCLUDE_DIR}
)

# 常规catkin_simple配置
cs_install()
cs_export()

# 链接示例：可执行文件链接
cs_add_executable(your_executable src/your_source.cpp)
# 必须同步链接faiss的依赖blas、lapack、gfortran，否则会报undefined reference
target_link_libraries(your_executable faiss blas lapack gfortran ${catkin_LIBRARIES})

# gtest链接示例
catkin_add_gtest(your_test test/your_test.cpp)
target_link_libraries(your_test faiss blas lapack gfortran ${catkin_LIBRARIES})

3. 编译验证 #

清空之前的编译缓存，重新编译即可：

rm -rf build devel
catkin build

如果以上操作后仍有undefined reference错误，检查faiss编译时的指令集选项和当前程序的编译选项是否一致：如果faiss编译时开启了AVX2/FMA指令集，需在CMake中同步添加编译参数：

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mavx2 -mfma")

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