WSL环境下Qt动态链接失败但Docker容器中正常的问题排查

看起来你遇到的核心问题是：相同的项目配置和Qt库文件，在Docker的Ubuntu 18.04里能正常链接运行，但在WSL的同版本Ubuntu中，ldd显示libQt5Core.so.5找不到。结合你的环境和输出，我来帮你一步步分析可能的原因和解决方案：

最可能的原因：WSL挂载NTFS路径的符号链接问题 #

从你的ldd输出可以看到，WSL中程序的路径是/mnt/c/Users/ci/Documents/...——这是Windows的NTFS分区挂载到WSL的路径。而Docker中程序是放在Linux原生文件系统（/Install/...）。

Qt的动态库文件大量使用Linux符号链接（比如libQt5Core.so.5会指向具体版本的libQt5Core.so.5.x.y），但NTFS文件系统不支持Linux风格的符号链接，WSL访问这类路径时，符号链接会失效或者无法被正确解析。这就导致程序找不到实际的Qt库文件。

排查步骤：验证符号链接状态 #

在WSL终端中进入你的Qt库目录：

cd extern/qt-linux/lib
ls -l libQt5Core*

正常情况下应该看到类似这样的输出（符号链接指向实际库文件）：

lrwxrwxrwx 1 user user       19 Aug  1 10:00 libQt5Core.so -> libQt5Core.so.5.12.8
lrwxrwxrwx 1 user user       19 Aug  1 10:00 libQt5Core.so.5 -> libQt5Core.so.5.12.8
-rwxr-xr-x 1 user user 5999872 Aug  1 10:00 libQt5Core.so.5.12.8

如果在WSL中看到符号链接显示为普通文件，或者提示“broken link”，那就确认是NTFS挂载导致的符号链接失效问题。

其他可能的原因及排查 #

1. RPATH配置是否生效 #

你在CMake中设置了CMAKE_INSTALL_RPATH "$ORIGIN/../lib"，需要确认这个配置是否正确写入了二进制文件：
在WSL的Install/bin目录下执行：

readelf -d hello-world | grep -E "(RPATH|RUNPATH)"

正常输出应该包含$ORIGIN/../lib。如果没有，可能是：

• 你的linux-toolchain.cmake文件覆盖了RPATH相关设置，检查该文件是否有CMAKE_SKIP_RPATH或类似配置。
• 可以尝试在CMake中同时设置RUNPATH（部分系统优先使用RUNPATH）：

  set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
  set(CMAKE_INSTALL_RPATH "$ORIGIN/../lib")
  set(CMAKE_INSTALL_RUNPATH "$ORIGIN/../lib")
  

2. 库文件权限问题 #

WSL访问NTFS路径时，文件权限可能会被默认设置，导致Qt库没有可执行权限：

ls -l extern/qt-linux/lib/libQt5Core.so.5.*

确保输出中包含-rwxr-xr-x（有x权限）。如果权限不对，执行：

chmod +x extern/qt-linux/lib/*.so*

解决方案 #

优先解决：将Qt库移到WSL原生文件系统 #

把extern/qt-linux目录复制到WSL的原生路径下（比如~/projects/your-project/extern/qt-linux），然后修改CMakeLists.txt中的路径：

if(UNIX)
set(Qt5Core_DIR "~/projects/your-project/extern/qt-linux/lib/cmake/Qt5Core")
# 或者用相对路径，确保项目在WSL原生路径下
# set(Qt5Core_DIR "${CMAKE_CURRENT_SOURCE_DIR}/extern/qt-linux/lib/cmake/Qt5Core")
install(DIRECTORY ${PROJECT_SOURCE_DIR}/extern/qt-linux/lib/ DESTINATION lib)
endif()

WSL的原生ext4文件系统完全支持Linux符号链接，这应该能解决核心问题。

临时测试：手动设置LD_LIBRARY_PATH #

如果不想移动文件，可以临时设置环境变量测试是否是路径问题：

export LD_LIBRARY_PATH="${CMAKE_CURRENT_SOURCE_DIR}/Install/lib:$LD_LIBRARY_PATH"
cd Install/bin
./hello-world

如果程序能正常运行，说明确实是路径解析的问题，优先采用移动文件到WSL原生系统的方案。

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