libsodium引用报错FileNotFoundError: [Errno 2] No such file or directory: b‘liblibsodium.a‘

问题

操作系统环境：Ubuntu 22.04

在安装一个工具应用时，这个应用使用到了chacha20加密算法，所以需要依赖libsodium。按照网上教程下载源码并编译安装：

sudo apt install build-essential
wget https://download.libsodium.org/libsodium/releases/libsodium-1.0.18.tar.gz
tar xf libsodium-1.0.18.tar.gz
cd libsodium-1.0.18
./configure
make
sudo make install
ldconfig

当启动该工具应用时出现报错：

File "/home/ubuntu/.local/lib/python3.7/site-packages/*****/crypto/util.py", line 80, in find_librarypath = ctypes.util.find_library(name)File "/usr/lib/python3.7/ctypes/util.py", line 341, in find_library_get_soname(_findLib_gcc(name)) or _get_soname(_findLib_ld(name))File "/usr/lib/python3.7/ctypes/util.py", line 147, in _findLib_gccif not _is_elf(file):File "/usr/lib/python3.7/ctypes/util.py", line 99, in _is_elfwith open(filename, 'br') as thefile:
FileNotFoundError: [Errno 2] No such file or directory: b'liblibsodium.a'

解决方法

首先确认了libsodium的安装过程，整个安装步骤没有报错，根据安装日志，也在/usr/local/lib/下找到了libsodium.a文件。
网上搜索这个问题，遇到同一问题的人很少，但是却有很多人遇到另一个库"liblibc.a"的报错，他们的解决方案是在libc.a的同一目录下建立软连接liblibc.a，抱着试一试的心态，我在/usr/local/lib下建立了一个软连接

cd /usr/local/lib
sudo ln -s libsodium.a liblibsodium.a

这时候再运行应用，果然运行正常。

问题原因分析

根据报错日志

 File "/usr/lib/python3.7/ctypes/util.py", line 341, in find_library_get_soname(_findLib_gcc(name)) or _get_soname(_findLib_ld(name))File "/usr/lib/python3.7/ctypes/util.py", line 147, in _findLib_gccif not _is_elf(file):File "/usr/lib/python3.7/ctypes/util.py", line 99, in _is_elfwith open(filename, 'br') as thefile:

我们从下往上，定位是在哪一步添加了多出来的lib前缀。
通过分析源码，我们可以发现

elif os.name == "posix":# Andreas Degert's find functions, using gcc, /sbin/ldconfig, objdumpimport re, tempfile........def _findLib_gcc(name):# Run GCC's linker with the -t (aka --trace) option and examine the# library name it prints out. The GCC command will fail because we# haven't supplied a proper program with main(), but that does not# matter.expr = os.fsencode(r'[^\(\)\s]*lib%s\.[^\(\)\s]*' % re.escape(name))........res = re.findall(expr, trace)if not res:return Nonefor file in res:# Check if the given file is an elf file: gcc can report# some files that are linker scripts and not actual# shared objects. See bpo-41976 for more detailsif not _is_elf(file):continuereturn os.fsdecode(file)

在报错日志中调用的_findLib_gcc方法中，是通过正则表达式来查找库文件的，而这里的正则表达式：

 expr = os.fsencode(r'[^\(\)\s]*lib%s\.[^\(\)\s]*' % re.escape(name))

已经自动在库名称前添加了lib前缀。同样的根据python官方文档

ctypes.util.find_library(name)
Try to find a library and return a pathname. name is the library name without any prefix like lib, suffix like .so, .dylib or version number (this is the form used for the posix linker option -l). If no library can be found, returns None.
The exact functionality is system dependent.

要求name中是不能含有lib前缀的。所以这时候我们要检查应用在调用find_library(name)时，传入的name是否含有额外的lib前缀了。
查看find_library的调用源码

def find_library(possible_lib_names, search_symbol, library_name,custom_path=None):import ctypes.util........lib_names = []for lib_name in possible_lib_names:lib_names.append(lib_name)lib_names.append('lib' + lib_name)for name in lib_names:if os.name == "nt":paths.extend(find_library_nt(name))else:path = ctypes.util.find_library(name)if path:paths.append(path)

果然是有一个加lib前缀的操作

lib_names.append('lib' + lib_name)

我们只要注释掉这行代码问题就能解决了。所以这是一个find_library调用不规范引起的报错。

补充

有的电脑上不会发生这个问题，因为还有一个逻辑间接导致的问题的出现，我这台电脑正好是多重因素赶上了。
即使加了多余的前缀lib，在执行re.findall(expr, trace)方法，大部分电脑返回的结果应该是空，但是我这台电脑trace里正巧有个报错信息，含有liblibsodium字段，导致正则表达式匹配出来的结果不为空，才会导致后续的打开文件失败。

b'/usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/Scrt1.o\n
/usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/crti.o\n
/usr/lib/gcc/x86_64-linux-gnu/11/crtbeginS.o\n
/usr/bin/ld: cannot find -llibsodium: No such file or directory\n
/usr/bin/ld: note to link with /usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/libsodium.a use -l:libsodium.a or rename it to liblibsodium.a\n
/usr/lib/gcc/x86_64-linux-gnu/11/libgcc.a\n
/usr/lib/gcc/x86_64-linux-gnu/11/libgcc_s.so\n
/usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/libgcc_s.so.1\n
/usr/lib/gcc/x86_64-linux-gnu/11/libgcc.a\n
collect2: error: ld returned 1 exit status\n'

参考：
ctypes.util.find_library(“libc”) fails
re — Regular expression operations