RPM 包依赖查询详解

## 一、背景说明

在基于 RPM 包管理体系的 Linux 发行版（如 CentOS、RHEL、Rocky Linux 等）中，软件包之间存在复杂的依赖关系。正确理解和分析依赖关系，是保障系统稳定运行、完成软件部署以及进行故障排查的关键能力。

RPM 工具本身提供了基础的依赖查询能力，而结合 YUM/DNF 及其扩展工具，可以实现更完整的依赖分析。

本文从实际运维场景出发，系统梳理 RPM 依赖查询方法及最佳实践。

---

## 二、RPM 基础依赖查询

### 2.1 查询已安装包的依赖（Requires）

用于查看某个已安装软件包在运行时所依赖的所有组件。

```bash
rpm -qR <package_name>
```

示例：

```bash
rpm -qR nginx
```

输出内容包括：

* 动态链接库（.so）
* 可执行文件
* 系统能力（capability）

适用场景：

* 分析程序运行依赖
* 排查运行时报错（缺库）

---

### 2.2 查询反向依赖（What Requires）

用于查看当前包被哪些软件依赖。

```bash
rpm -q --whatrequires <package_name>
```

示例：

```bash
rpm -q --whatrequires openssl
```

适用场景：

* 升级或卸载前评估影响范围
* 依赖链分析

---

### 2.3 查询提供能力（Provides）

RPM 依赖并非完全基于包名，而是基于“能力（capability）”。

```bash
rpm -q --provides <package_name>
```

示例：

```bash
rpm -q --provides glibc
```

说明：

* 一个包可以提供多个 capability
* 依赖关系实际上是 Requires → Provides 的匹配

---

## 三、查询未安装 RPM 文件依赖

在离线安装或预检查场景中，常需要分析未安装的 RPM 文件。

### 3.1 查询 RPM 文件依赖

```bash
rpm -qpR <package.rpm>
```

示例：

```bash
rpm -qpR nginx-1.20.1.rpm
```

说明：

* `-p` 表示针对文件（package file）
* 不需要安装即可查看依赖

---

### 3.2 查询 RPM 文件提供能力

```bash
rpm -qp --provides <package.rpm>
```

适用场景：

* 分析包是否满足某些依赖
* 构建离线依赖集合

---

## 四、基于 YUM / DNF 的依赖分析（推荐）

RPM 仅依赖本地数据库，不解析仓库依赖关系。在实际生产环境中，建议使用 YUM 或 DNF 进行补充分析。

---

### 4.1 查询依赖列表（deplist）

```bash
yum deplist <package_name>
```

或：

```bash
dnf deplist <package_name>
```

特点：

* 展示依赖项及其来源仓库
* 包含候选提供者

---

### 4.2 使用 repoquery 查询依赖

`repoquery` 提供更强大的依赖分析能力。

安装工具：

```bash
yum install yum-utils
```

查询依赖：

```bash
repoquery --requires <package_name>
```

---

### 4.3 查询反向依赖

```bash
repoquery --whatrequires <package_name>
```

---

### 4.4 构建依赖树

```bash
repoquery --tree-requires <package_name>
```

输出为树状结构，适用于：

* 分析复杂依赖链
* 排查深层依赖问题

---

## 五、缺失依赖排查方法（重点）

### 5.1 常见错误示例

在安装 RPM 时：

```bash
rpm -ivh example.rpm
```

可能出现：

```
error: Failed dependencies:
    libxxx.so()(64bit) is needed by example
```

---

### 5.2 定位依赖来源

通过以下命令查找提供该依赖的包：

```bash
yum provides "*/libxxx.so"
```

或：

```bash
repoquery --whatprovides "*/libxxx.so"
```

说明：

* 使用通配路径匹配文件
* 可快速定位依赖来源包

---

### 5.3 标准排障流程

建议遵循以下步骤：

1. 查看依赖

```bash
   rpm -qpR package.rpm
   ```

2. 定位提供者

```bash
   repoquery --whatprovides <dependency>
   ```

3. 安装依赖

```bash
   yum install <package>
   ```

---

## 六、离线环境依赖处理

在无外网环境中，可提前下载依赖包：

```bash
yum install --downloadonly --downloaddir=./pkgs <package_name>
```

说明：

* 会下载目标包及其所有依赖
* 适用于内网部署、生产隔离环境

---

## 七、运维实践建议

### 7.1 优先使用仓库工具

* RPM：适用于基础查询
* YUM / DNF：适用于完整依赖分析

---

### 7.2 避免直接强制安装

```bash
rpm -ivh --nodeps
```

风险：

* 破坏依赖关系
* 导致运行异常

仅在明确依赖影响时使用。

---

### 7.3 构建依赖基线

在标准化部署场景中，应：

* 固定仓库版本
* 记录依赖清单
* 构建离线安装包集合

---

## 八、总结

RPM 依赖管理的核心在于以下三点：

1. **理解依赖关系本质（Requires / Provides）**
2. **区分本地查询与仓库查询能力**
3. **建立规范的排障流程**

在生产环境中，建议将 `rpm` 与 `repoquery` 结合使用，以获得完整、准确的依赖分析能力，从而提升部署效率与系统稳定性。