【超详细教程】解决libxxx.so: cannot open shared object file: No file or directory

一、参考资料

error while loading shared libraries的解决方案

libascend_hal.so: cannot open shared object file:No such…解决办法-云社区-华为云 (huaweicloud.com)

二、相关介绍

1. -lxxx.so命名

`lxxx` means `lib + lib-name + .so`

lc means libc.so, 
lltdl means libltdl.so, 
lXtst means libXts.so

2. 查找 .so 文件

ld -lxxx --verbose

gcc -lxxx --verbose

locate libhdf5.so
/usr/bin/ld: cannot find -lhdf5

# 这表示找不到库文件 libhdf5.so
# 若是其它库文件,则是 cannot find -lxxx ,其中 xxx 是库文件的名字。

解释说明

  • -lxxx 表示 lib + lib-name + .so。例如,-lhdf5 表示 libhdf5.so

3. 静态库与动态库

静态库 GCC 进行链接时,会把静态库中代码打包(复制)到可执行程序中,程序运行时,可执行文件里就包含了所有的代码,直接运行。

动态库 GCC 进行链接时,动态库的代码不会被打包到可执行程序中,只是打包一些有关于动态库的信息,在运行时才找到动态库文件位置,加载代码后才运行。

4. ldd指令

通过 ldd (list dynamic dependencies) 指令,检查动态库依赖关系。

在这里插入图片描述

5. 搜索动态库路径

当系统加载可执行代码时候,能够知道其所依赖库的名字,但是还需要知道绝对路径。此时就需要系统的动态载入器来获取该绝对路径。

对于ELF 格式的可执行程序,是由 ld-linux.so 来完成的,找到库文件后将其载入内存。它先后搜索的顺序是:

  1. elf文件的 DT_RPATH 段;
  2. 环境变量 LD_LIBRARY_PATH
  3. /etc/ld.so.cache文件列表;
  4. /lib/usr/lib/usr/local/lib 目录。

6. ld.so.conf配置文件

ld.so.conf配置的作用是,将 /etc/ld.so.conf 列出的库文件路径缓存到 /etc/ld.so.cache以供使用。当安装完一些库文件,或者在 /etc/ld.so.conf 配置文件中增加新的库文件搜索路径,运行一下ldconfig,使所有的库文件都被缓存到文件 /etc/ld.so.cache 中。如果没有做以上操作,可能会找不到刚安装的库。

可以通过以下指令,更新ld.so.conf配置文件:

# 打开配置文件
sudo vi /etc/ld.so.conf

# 新增一行
/usr/local/lib

# 使配置生效
sudo ldconfig

# 查看配置
/sbin/ldconfig -v

三、问题描述

1. 情况一

/usr/bin/ld: cannot find -lxxx 的解决办法

make编译时,找不到 lxxx.so 动态库,导致报错。

/usr/bin/ld: cannot find -lc
/usr/bin/ld: cannot find -lltdl
/usr/bin/ld: cannot find -lXtst

2. 情况二

run运行可执行文件,找不到 .so 动态库,导致报错。

error while loading shared libraries: libXXXXXXX.so.1: cannot open shared object file: No such file or directory

libcal.so: cannot open shared object file: No file or directory

在这里插入图片描述

四、问题分析

1. 情况一

1.1 分析原因

默认情况下,编译器只会使用 /lib/usr/lib 这两个目录下的库文件,通常通过源码包进行安装时,如果不指定 –prefix,会将库安装在 /usr/local/lib 目录下;当运行程序需要链接动态库时,提示找不到相关的 .so 库,会报错。也就是说,/usr/local/lib目录不在系统默认的库搜索目录中,需要将目录加进去。

1.2 解决办法

可以设定 LD_LIBRARY_PATH 环境变量,程序运行时会在此环境变量指定的文件夹下寻找动态链接库。

1.2.1 修改环境变量(永久有效)

其实,对于由普通用户自己编译生成的.so库文件,比较好的做法是将这些.so库文件的路径用export指令加入到~/.bashrc中的LD_LIBRARY_PATH变量中,LD_LIBRARY_PATH是程序运行需要链接.so库时会去查找的一个目录,~/.bashrc是登陆或打开shell时会读取的文件,这样,每次用户登录时,都会把这些.so库文件的路径写入LD_LIBRARY_PATH,这样就可以正常地使用这些.so库文件了。

普通用户可直接修改~/.bashrc~/.bash_profile,该修改仅对当前用户有效。
root用户可修改/etc/profile,且对所有用户都有效。

以修改 ~/.bashrc 配置文件为例:

# 打开配置文件
vim ~/.bashrc

# 添加配置
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/hua/Myproject/1_basic/lib

# 若修改环境变量 LD_LIBRARY_PATH 不奏效,则修改变量 LIBRARY_PATH
export LIBRARY_PATH=$LIBRARY_PATH:/home/hua/Myproject/1_basic/lib

# 更新配置
source ~/.bashrc

1.2.2 修改环境变量(临时)

在终端使用export命令来配置环境变量,但仅限于当前终端;对于其他终端窗口则需要重新使用export命令才起作用。
export配置环境变量的格式为:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/hua/Myproject/1_basic/lib

1.2.3 运行成功

再次检查动态库依赖关系。

在这里插入图片描述
在这里插入图片描述

2. 情况二

2.1 分析原因

如果更新 ld.so.conf 配置文件,还是出现以上错误,那可能的原因是:当前用户没有读取库目录的权限。从其他主机上拷贝一些.so动态库,然后用root权限放到了/usr/local/lib 目录中(普通用户没有该目录的写权限),然后切换用户运行程序时,始终提示找不到.so库。用root权限增加到 /usr/local/lib 目录中的.so文件,对于普通用户而言,是没有访问权限的。所以,以普通用户运行程序,当需要链接.so库时,在/usr/local/lib中是查找不到的

2.2 解决办法

修改.so文件的权限。

sudo chown yoyo:yoyo /usr/local/lib/libhdf5.so

3. 情况三

能找到 .so 文件。

3.1 查找 .so 文件

locate libiconv.so
$ locate libiconv.so
/home/user/anaconda3/lib/libiconv.so   # <-- right here
/home/user/anaconda3/lib/libiconv.so.2
/home/user/anaconda3/lib/libiconv.so.2.5.1
/home/user/anaconda3/lib/preloadable_libiconv.so
/home/user/anaconda3/pkgs/libiconv-1.14-0/lib/libiconv.so
/home/user/anaconda3/pkgs/libiconv-1.14-0/lib/libiconv.so.2
/home/user/anaconda3/pkgs/libiconv-1.14-0/lib/libiconv.so.2.5.1

3.2 创建软连接

Link it to the right place, usually it is /lib64 or /usr/lib64

$ sudo ln -s /home/user/anaconda3/lib/libiconv.so /usr/lib64/

4. 情况四

能找到 .so 文件,但不符合命名规则,创建软链接即可。例如:libasound.so.2

ln -s libasound.so.2 libasound.so
sudo ln -s /usr/lib/x86_64-linux-gnu/libboost_filesystem.so.1.65.1 /usr/lib/libboost_filesystem.so
sudo ln -s /usr/lib/x86_64-linux-gnu/libboost_system.so.1.65.1 /usr/lib/libboost_system.so

5. 情况五

需要用户编译生成的 .so 文件。

When you compile your program you must supply the path to the library; in g++ use the -L option:

编译c/c++程序,需要添加 -L 选项,才能生成 lib 链接库。

# c程序
g++ -L/path/foo/bar myprogram.cc -lxxx -o myprogram
# c++程序
g++ -L/home/user/myDir myprogram.cpp -lxxx -lxxx -o myprogram

6. 情况六

如果找不到 .so 文件,则下载安装。

  • google下载;
  • 百度下载;

6.1 示例一

sudo apt-get install libfoo-dev
# 如果apt-get安装失败,先添加apt源再安装
sudo add-apt-repository "deb http://security.ubuntu.com/ubuntu xenial-security main"
sudo apt update
sudo apt install libjasper1 libjasper-dev

6.2 示例二

unable to locate libjasper-dev
# 解决办法
sudo add-apt-repository "deb http://security.ubuntu.com/ubuntu xenial-security main" 
sudo apt update 
sudo apt install libjasper1 libjasper-dev

猜你喜欢

转载自blog.csdn.net/m0_37605642/article/details/130068402