aarch64交叉编译链接器无法找到/usr/local/lib下存在的库如何排查

链接器无法找到/usr/local/lib下库的核心原因有三点：

• 工具链文件中配置的set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)规则，会强制CMake查找库时仅在CMAKE_FIND_ROOT_PATH指定的目标根目录（即/opt/cross-pi-gcc-10.2.0-64/aarch64-linux-gnu）下拼接路径搜索，不会直接访问主机系统的绝对路径/usr/local/lib，实际搜索的路径是/opt/cross-pi-gcc-10.2.0-64/aarch64-linux-gnu/usr/local/lib，和你库存放的路径不匹配。
• 交叉编译场景下，/usr/local/lib是WSL2主机（x86_64架构）的默认库路径，就算链接器能搜到该路径下的文件，只要库是x86_64架构的，也无法和aarch64架构的目标程序链接，会直接报架构不匹配错误。
• 你配置的CMAKE_LIBRARY_PATH是CMake查找阶段的路径变量，不会自动传递给底层交叉链接器作为搜索路径，即使CMake查找阶段识别到了库，链接器拿不到对应路径也会抛出找不到库的错误。

• 第一步先校验库架构：执行file /usr/local/lib/libmytest_lib.so（静态库就把后缀换成.a），确认输出包含ARM aarch64字样，如果显示x86_64相关内容，说明这个库是用主机gcc编译的，根本不能用于交叉链接，必须用你安装的aarch64交叉编译器重新编译mytest_lib。
• 不要把交叉编译依赖的目标架构库存放在主机的/usr/local/lib路径下，统一放到交叉编译的sysroot目录中：你可以在CMAKE_FIND_ROOT_PATH对应的路径下创建usr/local/lib目录，也就是/opt/cross-pi-gcc-10.2.0-64/aarch64-linux-gnu/usr/local/lib，把校验通过的aarch64架构的libmytest_lib移动到这个目录下。
• 修改工具链文件，删除CMAKE_LIBRARY_PATH中配置的/usr/local/lib项，不需要额外配置CMAKE_LIBRARY_PATH，如果有自定义库存放路径，直接加到CMAKE_FIND_ROOT_PATH列表中即可，参考配置如下：

set(CMAKE_FIND_ROOT_PATH 
    /opt/cross-pi-gcc-10.2.0-64/aarch64-linux-gnu
    # 如有自定义库存放路径，按格式追加在下方即可
)
set(CMAKE_INCLUDE_PATH /opt/cross-pi-gcc-10.2.0-64/aarch64-linux-gnu/include)
set(CMAKE_PROGRAM_PATH  /opt/cross-pi-gcc-10.2.0-64/aarch64-linux-gnu/bin)

• 如果临时需要引用存放在其他位置的aarch64库，不要通过CMAKE_LIBRARY_PATH添加，直接在项目的CMakeLists.txt中给目标指定链接目录即可：

target_link_directories(mytest_demo PRIVATE /实际存放aarch64库的路径)
target_link_libraries(mytest_demo PRIVATE mytest_lib)

• 完全删除之前的build构建目录，重新执行cmake和make命令，旧的CMake缓存会保留之前的错误路径配置，增量修改配置经常不生效。

交叉编译时不要把目标架构的库和主机架构的库混放在主机系统默认路径下，极易引发架构混链问题，后续排查成本极高。

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