CMake find_library命令返回错误路径的原因排查

核心问题原因 #

1. 架构判断不兼容：部分x86_64架构的Linux发行版（如Debian/Ubuntu）中，CMAKE_HOST_SYSTEM_PROCESSOR会返回amd64而非x86_64，导致代码未进入x86_64对应的分支，find_library使用默认搜索路径后找到错误的不存在路径。
2. CMake缓存残留：若之前运行过CMake，可能已缓存错误的libCubeEye路径，后续执行时直接复用缓存值，跳过重新查找逻辑。

修复步骤 #

1. 验证架构变量实际值 #

先添加详细输出确认当前系统的架构标识：

message("CMAKE_HOST_SYSTEM_PROCESSOR = ${CMAKE_HOST_SYSTEM_PROCESSOR}")
message("CMAKE_SYSTEM_PROCESSOR = ${CMAKE_SYSTEM_PROCESSOR}")

执行CMake后查看输出，确认当前系统返回的架构字符串。

2. 修改CMake代码逻辑 #

兼容x86_64和amd64两种标识，同时限制find_library仅在指定路径搜索：

message("Host system: ${CMAKE_HOST_SYSTEM_PROCESSOR}")

set(CUBE_EYE_HINTS "")
if (CMAKE_HOST_SYSTEM_PROCESSOR STREQUAL "aarch64")
  set(CUBE_EYE_HINTS "thirdparty/aarch64/libcubeeye/lib/")
elseif(CMAKE_HOST_SYSTEM_PROCESSOR MATCHES "x86_64|amd64")
  if(UNIX)
    set(CUBE_EYE_HINTS "thirdparty/x86_64/libcubeeye/lib")
  elseif(WIN32)
    set(CUBE_EYE_HINTS "thirdparty/x86_64/libcubeeye/lib")
  endif()
endif()

# 强制仅在指定路径搜索，避免系统路径干扰
find_library(libCubeEye 
             NAMES libCubeEye.so libCubeEye.lib
             HINTS ${CUBE_EYE_HINTS}
             NO_CMAKE_SYSTEM_PATH)

message("Found libCubeEye at: ${libCubeEye}")

if (NOT libCubeEye)
  message(FATAL_ERROR "libCubeEye library not found")
endif()

3. 清理CMake缓存 #

删除项目目录下的缓存文件和目录，彻底清除旧配置：

rm -rf CMakeCache.txt CMakeFiles/

之后重新运行CMake生成构建文件。

额外注意事项 #

• 确认项目中thirdparty/x86_64/libcubeeye/lib/路径真实存在，且包含libCubeEye.so文件。
• 若为交叉编译场景，建议使用CMAKE_SYSTEM_PROCESSOR（对应目标架构）而非CMAKE_HOST_SYSTEM_PROCESSOR（对应主机架构）。

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