交叉编译时CMake无法找到CURL库的问题求助

问题背景 #

本地编译时，使用以下CMake配置可正常引入CURL库：

find_package(CURL REQUIRED)
include_directories(${CURL_INCLUDE_DIR})
target_link_libraries(${PROJECT_NAME} ${CURL_LIBRARIES})

但针对旧版Debian Stretch系统交叉编译时出现异常：已编译适配的GCC和glibc，其他本地库可正常使用，且通过以下脚本同步了目标系统的sysroot：

rsync -au --progress \
      --include=/lib/*** \
      --include=/opt/*** \
      --include=/usr \
      --include=/usr/include/*** \
      --include=/usr/lib/*** \
      --include=/usr/local \
      --include=/usr/local/lib/*** \
      --include=/usr/local/include/*** \
      --include=/usr/share \
      --include=/usr/share/cmake-3.7/*** \
      --exclude='*' \
      <target_system>/ \
      /opt/<local-sysroot>

错误信息 #

交叉编译配置阶段报错，显示找到的是主机系统的CURL 7.81.0，而非目标系统的7.52.1：

CMake Error at /usr/share/cmake-3.22/Modules/FindPackageHandleStandardArgs.cmake:230 (message):
  Could NOT find CURL (missing: CURL_LIBRARY CURL_INCLUDE_DIR) (found version
  "7.81.0")
Call Stack (most recent call first):
  /usr/share/cmake-3.22/Modules/FindPackageHandleStandardArgs.cmake:594 (_FPHSA_FAILURE_MESSAGE)
  /usr/share/cmake-3.22/Modules/FindCURL.cmake:181 (find_package_handle_standard_args)
  CMakeLists.txt:162 (find_package)

已配置的工具链文件 #

工具链文件已设置仅搜索sysroot路径：

set(root_fs_dir /opt/<local-sysroot>)
set(CMAKE_FIND_ROOT_PATH ${root_fs_dir})
set(CMAKE_SYSROOT ${root_fs_dir})
set(CMAKE_SYSTEM_PREFIX_PATH ${root_fs_dir})

set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)

# search headers and libraries in the target environment
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

已尝试的无效操作 #

创建CMake版本目录软链接，问题仍存在：

ln -s /opt/box-root-fs/usr/share/cmake-3.7/ /opt/box-root-fs/usr/share/cmake-3.22

目标sysroot中已包含完整的CURL相关文件。

问题原因与解决方法 #

1. FindCURL模块版本兼容性问题 #

主机使用的CMake 3.22自带的FindCURL模块，与目标系统Debian Stretch（CMake 3.7）中的旧版CURL探测逻辑不匹配。高版本模块可能依赖新的CURL特性或文件结构，导致无法识别旧版库。

解决方法：

• 从sysroot中复制<local-sysroot>/usr/share/cmake-3.7/Modules/FindCURL.cmake，替换主机CMake 3.22对应路径下的模块文件（注意备份原文件）
• 或在CMakeLists.txt中优先指定目标系统的模块路径：

set(CMAKE_MODULE_PATH "${root_fs_dir}/usr/share/cmake-3.7/Modules" ${CMAKE_MODULE_PATH})

2. rsync脚本路径覆盖不全 #

Debian Stretch的库文件可能存放在架构专属目录（如/usr/lib/x86_64-linux-gnu/），原rsync脚本的--include=/usr/lib/***未覆盖这类路径，导致库文件未同步到sysroot。

解决方法：
修改rsync脚本，添加架构目录的包含规则：

rsync -au --progress \
      --include=/lib/*** \
      --include=/opt/*** \
      --include=/usr \
      --include=/usr/include/*** \
      --include=/usr/lib/*** \
      --include=/usr/lib/x86_64-linux-gnu/*** \
      --include=/usr/local \
      --include=/usr/local/lib/*** \
      --include=/usr/local/include/*** \
      --include=/usr/share \
      --include=/usr/share/cmake-3.7/*** \
      --exclude='*' \
      <target_system>/ \
      /opt/<local-sysroot>

重新同步sysroot后再尝试编译。

3. 强制指定CURL路径 #

若自动查找仍失败，可在CMakeLists.txt中直接硬编码目标路径作为临时解决方案：

# 替换为sysroot中实际的CURL路径
set(CURL_INCLUDE_DIR /opt/<local-sysroot>/usr/include)
set(CURL_LIBRARY /opt/<local-sysroot>/usr/lib/x86_64-linux-gnu/libcurl.so)
find_package(CURL REQUIRED NO_MODULE)

4. 验证sysroot文件完整性与权限 #

检查sysroot中的CURL文件是否完整且可访问：

• 确认<local-sysroot>/usr/include/curl/目录存在并包含curl.h等头文件
• 确认<local-sysroot>/usr/lib/x86_64-linux-gnu/下存在libcurl.so、libcurl.a等库文件
• 确保所有文件权限正常，可被当前用户读取

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