交叉编译Qt5.15.14至AArch64时libdl检测失败问题求助

问题背景 #

在x86_64 Ubuntu 22.04主机上，使用ARM官网下载的aarch64-none-linux-gnu-gcc 9.2工具链交叉编译Qt5.15.14至AArch64平台。目标sysroot为安装了libc6-dev的Ubuntu 20.04基础镜像，工具链自带Glibc版本为2.30，sysroot中的Glibc版本为2.31。尝试启用eglfs时，configure脚本抛出以下错误：

ERROR: Feature 'dlopen' was enabled, but the pre-condition 'config.unix && libs.libdl' failed.
ERROR: Feature 'egl' was enabled, but the pre-condition '(features.opengl || features.openvg) && (features.angle || libs.egl) && (features.dlopen || !config.unix || config.integrity)' failed.
ERROR: Feature 'eglfs' was enabled, but the pre-condition '!config.android && !config.darwin && !config.win32 && !config.wasm && features.egl' failed.

推测核心问题在于libs.libdl测试未通过，因此复制Qt自带的config.tests/libdl/main.cpp进行验证：

/* Generated by configure */
#include <dlfcn.h>
int main(int argc, char **argv)
{
    (void)argc; (void)argv;
    /* BEGIN TEST: */
    dlclose(dlopen(0, 0));
    dlsym(RTLD_DEFAULT, 0);
    dlerror();
    /* END TEST */
    return 0;
}

测试结果 #

• 不加sysroot交叉编译：成功生成a.out，ldd显示依赖正常
• 在目标机通过qemu编译：成功生成a.out，ldd显示依赖正常
• 加sysroot交叉编译：链接报错，提示__dlopen等符号未定义（这些符号实际存在于sysroot的libc.a中，但链接器无法找到）
• 加sysroot并显式指定链接libdl-2.31.so：编译成功

疑问解答 #

1. 链接器如何处理sysroot中的符号链接？--sysroot会影响链接器行为吗？ #

• --sysroot参数会强制链接器将指定路径作为虚拟根目录，所有库的查找、头文件引用都会基于这个路径，完全替代主机系统的根目录
• 链接器处理sysroot内的符号链接时，会自动跟随链接指向的实际文件，但需注意符号链接的路径类型：如果是相对路径，会基于sysroot的路径解析；如果是绝对路径，链接器会在sysroot下的对应绝对路径中查找，而非主机系统的绝对路径
• 你的场景中，工具链自带Glibc（2.30）与sysroot中Glibc（2.31）版本不一致，链接器默认可能优先调用工具链自带的库文件，但指定--sysroot后，需确保链接器能正确定位到sysroot内的libdl相关库（注：Glibc 2.31中libdl已合并到libc，但链接时仍可通过-ldl显式引用）

2. 如何正确配置以解决该问题？ #

• 显式传递sysroot与链接参数：在Qt configure命令中，除了指定--sysroot，还需在编译、链接参数中明确传递该路径并添加-ldl：

  ./configure --prefix=/opt/qt5-aarch64 \
              --host=aarch64-none-linux-gnu \
              --sysroot=/path/to/ubuntu20.04-sysroot \
              --enable-eglfs \
              QMAKE_CFLAGS="--sysroot=/path/to/ubuntu20.04-sysroot" \
              QMAKE_LFLAGS="--sysroot=/path/to/ubuntu20.04-sysroot -ldl"
  

• 修复sysroot内的库符号链接：检查sysroot的lib/aarch64-linux-gnu/目录，确保存在libdl.so符号链接指向libdl-2.31.so，若缺失可手动创建：

  ln -s libdl-2.31.so /path/to/sysroot/lib/aarch64-linux-gnu/libdl.so
  

• 统一Glibc版本（可选）：由于工具链与sysroot的Glibc版本存在差异，可能引发潜在兼容性问题，建议尽量使用与sysroot版本匹配的交叉编译工具链；若无法更换工具链，显式指定-ldl可强制链接器找到所需符号
• 预设置环境变量：configure前设置环境变量，让libdl测试阶段自动加载链接参数：

  export LDFLAGS="--sysroot=/path/to/sysroot -ldl"
  export CFLAGS="--sysroot=/path/to/sysroot"
  

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