本质是动态链接器未在预设路径中找到.so文件；先用ldd确认not found项，再检查文件存在性、路径是否在RPATH/RUNPATH、LD_LIBRARY_PATH或/etc/ld.so.cache中，并注意权限、版本软链接及setuid对环境变量的屏蔽。
运行时找不到动态库：先看 ldd 输出是否报 not found
程序启动失败、提示 error while loading shared libraries: libxxx.so: cannot open shared object file: No such file or directory，本质是动态链接器（ld-linux.so）在预设路径里没找到依赖的 .so 文件。别急着改代码，先用 ldd ./your_program 看真实依赖链——如果某行显示 libxxx.so => not found，说明该库确实没被定位到。
这时要确认两点：libxxx.so 文件物理存在吗？它所在的目录是否在链接器搜索路径中？常见误区是以为 LD_LIBRARY_PATH 设置了就一定生效，但若程序被 setuid 或由 systemd 启动，该变量会被忽略。
- 检查文件是否存在：
find /usr/local/lib /opt/myapp/lib -name "libxxx.so*" - 确认权限：目标
.so文件需有可读+可执行（x）位，否则链接器拒绝加载 - 注意版本后缀：
libfoo.so.1.2.3和libfoo.so（软链接）要同时存在，仅放带版本号的文件可能不被识别
LD_LIBRARY_PATH 临时生效但不推荐长期使用
它只是运行时的“快捷通道”，对当前 shell 及其子进程有效：LD_LIBRARY_PATH=/opt/myapp/lib ./myapp。但它绕过了系统级配置，容易引发环境不一致问题——比如 CI 构建成功，上线后因未设置该变量而崩溃。
更麻烦的是安全限制：当二进制设置了 setuid（如 sudo），glibc 会直接清空 LD_LIBRARY_PATH，此时该方式完全失效。
立即学习“C++免费学习笔记（深入）”；
- 开发调试可用，但禁止写入启动脚本或 Dockerfile 的
ENV指令中 - 路径之间用
:分隔，结尾不要加/，否则可能触发解析异常 - 优先级高于
/etc/ld.so.cache，但低于编译时硬编码的RPATH
编译时嵌入 RPATH：最可控的路径固化方案
用 -Wl,-rpath,/path/to/libs 把路径直接写进可执行文件的 DT_RUNPATH 或 DT_RPATH 段，运行时链接器优先查这里。相比 LD_LIBRARY_PATH，它不依赖外部环境，且不受 setuid 影响。
注意 RPATH 和 RUNPATH 行为差异：旧版工具链默认写 RPATH（优先级高于 LD_LIBRARY_PATH），新版默认 RUNPATH（优先级低于 LD_LIBRARY_PATH）。可通过 readelf -d ./your_program | grep PATH 确认。
- 推荐写法：
g++ -Wl,-rpath,'$ORIGIN/../lib' main.cpp -lfoo，其中$ORIGIN表示可执行文件所在目录，支持相对路径 - 避免绝对路径硬编码（如
/home/user/lib），否则迁移机器必挂 - 多个路径用
:连接：-Wl,-rpath,'$ORIGIN/lib:$ORIGIN/../third_party/lib'
系统级注册：修改 /etc/ld.so.conf.d/ 并运行 ldconfig
适用于全局共享库（如自己编译的 OpenSSL、Boost），让所有程序都能访问。把路径写入 /etc/ld.so.conf.d/myapp.conf（内容只有一行：/opt/myapp/lib），再执行 sudo ldconfig，它会扫描该路径下所有 .so 文件并更新 /etc/ld.so.cache。
这个缓存是二进制启动时实际查询的依据，不是每次实时遍历文件系统。所以改完配置不执行 ldconfig，等于没改。
- 路径必须是绝对路径，不能含
$ORIGIN或环境变量 - 确保
/opt/myapp/lib下的.so文件有正确符号链接（如libfoo.so -> libfoo.so.1.2.3），否则ldconfig可能跳过它们 - 普通用户无权写
/etc/下文件，生产环境应走包管理或容器镜像构建流程，而非手动sudo
真正棘手的情况往往是多级依赖嵌套：A 依赖 B，B 依赖 C，但 C 的路径没被 A 的 RPATH 覆盖，也未进入系统缓存。这时候光看 ldd 主程序不够，得逐层检查每个依赖库的 DT_RUNPATH ——用 readelf -d /path/to/libB.so | grep PATH 才能暴露隐藏路径缺失点。
