Ubuntu 22.04 LTS上源码编译json-c库的深度实践指南

当你在Ubuntu 22.04 LTS上从源码编译安装json-c库后，运行程序时却遇到libjson-c.so.5: cannot open shared object file的错误提示，这种动态链接库查找失败的问题在Linux开发中并不罕见。本文将带你深入理解Linux动态链接库的查找机制，并提供多种解决方案，让你彻底掌握这类问题的排查与修复方法。

1. 环境准备与源码编译

在开始之前，我们需要确保系统具备编译json-c所需的基础工具链。打开终端，执行以下命令安装必要的依赖：

bash复制sudo apt update
sudo apt install -y build-essential cmake git

接下来，从GitHub克隆最新的json-c源码：

bash复制git clone https://github.com/json-c/json-c.git
cd json-c

创建一个独立的构建目录是个好习惯，可以保持源码目录的整洁：

bash复制mkdir build
cd build

现在，我们可以使用CMake生成Makefile并进行编译：

bash复制cmake ..
make

提示：如果编译过程中出现错误，可以尝试添加-DCMAKE_BUILD_TYPE=Release参数来指定构建类型。

编译完成后，使用root权限安装库文件：

bash复制sudo make install

默认情况下，json-c会被安装到/usr/local/lib目录下，头文件则安装在/usr/local/include/json-c目录中。

2. 动态链接库查找机制深度解析

当你在程序中使用#include <json-c/json.h>并链接-ljson-c时，系统需要能够找到对应的动态链接库文件。Linux系统通过以下几个路径来查找动态库：

1. 编译时指定的RPATH：在链接时通过-Wl,-rpath指定的路径
2. LD_LIBRARY_PATH环境变量：用户自定义的库搜索路径
3. /etc/ld.so.conf配置文件：系统配置的库搜索路径
4. 默认路径：通常是/lib和/usr/lib

在Ubuntu系统中，/etc/ld.so.conf通常会包含/etc/ld.so.conf.d/*.conf，而默认情况下/usr/local/lib并不在其中，这就是为什么我们安装到/usr/local/lib的库文件无法被系统自动找到的原因。

3. 解决库查找问题的五种方案

3.1 方案一：使用ldconfig更新库缓存

ldconfig是Linux系统中用于维护共享库缓存的工具。我们可以通过以下步骤让系统识别新安装的库：

bash复制sudo ldconfig -v | grep json-c

如果发现json-c库没有被识别，我们需要将/usr/local/lib添加到库配置中：

bash复制echo '/usr/local/lib' | sudo tee /etc/ld.so.conf.d/json-c.conf
sudo ldcon