Linux动态链接错误本质是ld-linux.so加载.so失败，主因是路径未识别、版本不匹配、符号冲突或权限异常；需用ldd查依赖、按搜索路径顺序排查、核对SONAME与符号导出。
Linux 下运行程序时提示“找不到共享库”或“undefined symbol”，本质是动态链接器（ld-linux.so）在加载 .so 文件过程中失败。问题不总出在“库没装”，更常源于路径未识别、版本不匹配、符号冲突或权限异常。
确认缺失的是哪个库？用 ldd 看清依赖链
ldd 是第一排查工具，它模拟动态链接器行为，列出可执行文件直接依赖的所有共享库及其解析结果：
- 显示
not found：该库名存在，但系统在默认路径中未定位到对应文件 - 显示
=> not found：该库被其他 .so 间接依赖，但未被满足 - 显示真实路径（如
/lib64/libc.so.6 => /lib64/libc.so.6 (0x...)）：已成功定位 - 若某行末尾为空（仅库名后跟空白），说明该库未被找到且无替代路径
注意：ldd 对 setuid 程序会禁用，此时可用 readelf -d ./prog | grep NEEDED 查原始依赖项，再逐个验证。
库文件存在却报 not found？检查动态链接器搜索路径
Linux 不按文件系统路径盲目查找，而是遵循固定顺序搜索：
- 可执行文件的
DT_RUNPATH或DT_RPATH（由编译时-rpath指定，优先级最高） - 环境变量
LD_LIBRARY_PATH（用户临时指定，开发调试常用） - /etc/ld.so.cache 中缓存的路径（由
ldconfig扫描/etc/ld.so.conf及其包含的目录生成） - 默认路径：
/lib、/usr/lib（64位系统通常是/lib64、/usr/lib64）
验证当前生效路径：cat /etc/ld.so.cache | strings | head -20 或运行 ldconfig -p | grep yourlib。若库在自定义目录（如 /opt/myapp/lib），需将其加入 /etc/ld.so.conf.d/myapp.conf 并执行 sudo ldconfig 刷新缓存。
版本号对不上？理解 soname 与兼容性机制
动态库文件名通常含版本号（如 libssl.so.1.1），但程序链接时记录的是 SONAME（可通过 readelf -d /path/to/lib.so | grep SONAME 查看）。链接器只认 SONAME 字符串，而非完整文件名。
- 若程序需要
libssl.so.1.1，而系统只有libssl.so.3，即使功能相似也不兼容——需安装对应版本或重新编译程序 - 常见误操作：仅复制
.so文件却不建立正确软链接。例如，安装完libfoo.so.2.4后，应确保有libfoo.so.2 -> libfoo.so.2.4和libfoo.so -> libfoo.so.2 - 用
objdump -p binary | grep NEEDED可确认程序真正需要的 so name
符号未定义（undefined symbol）？不只是库缺失的问题
“undefined symbol” 错误常被误判为缺库，实则可能源于：
- 库版本升级导致函数签名变更或移除（如 OpenSSL 1.1 → 3.0 移除了部分低层 API）
- 多个同名库混用（如同时加载系统
libpng和自编译的libpng），符号被错误解析 - 库本身未导出该符号（编译时加了
-fvisibility=hidden且未显式__attribute__((visibility("default")))） - 使用
dlopen()加载时未传RTLD_GLOBAL，导致后续 dlsym 找不到前序库中的符号
定位具体缺失符号：nm -D /path/to/lib.so | grep symbol_name 或 objdump -T /path/to/lib.so | grep symbol_name。若符号确实不存在，则需更换兼容版本库或修改调用代码。
不复杂但容易忽略：多数动态库问题不是“没装”，而是“没找对”或“找错了版本”。从 ldd 出发，顺路径、查 so name、验符号，三步闭环，基本覆盖 90% 场景。
