Rocky Linux 10 教程 / 排查软件包错误、重新安装文件并撤销已核对的DNF事务

在 Rocky Linux 10 中,必须在区分名称、软件仓库、元数据、依赖关系和安装文件的问题后解决软件包错误。DNF 历史用于调查已更改的内容并恢复特定的软件包操作,但它不是备份,不能恢复用户数据或将整个服务器恢复到以前的状态。

首先收集错误消息和当前状态

发生错误后,先记录最初执行的命令、完整错误信息、退出状态和当前安装状态,再决定是否重试。不要立即添加强制选项。如果 SSH 连接在中途断开,实际的软件包安装可能已经完成,因此请先检查保存的状态。

cat /etc/rocky-release
dnf --version
rpm -q tree
dnf repolist --enabled
sudo dnf history list
sudo dnf check

DNF(Dandified YUM)是一个用于管理软件仓库中软件包和依赖关系的工具,而RPM(RPM 软件包管理器)是一个用于管理已安装软件包信息和文件的基础工具。记录的原实验环境是 Rocky Linux 10.2、DNF 4.20.0 和 RPM 4.19.1.1。在专用虚拟机(VM)上使用了默认软件仓库,并且在开始时未安装 tree。dnf check 检查一致性问题,例如已安装软件包的依赖关系,没有输出并不意味着所有服务或用户数据都已被检查。

代表性线索 需要首先区分的问题
未找到匹配的参数 名称、版本和架构是否正确,以及所需的仓库是否提供它们
元数据、镜像或名称解析错误 网络、DNS、时间、代理、缓存和仓库状态
未提供、请求冲突 所需依赖、当前已安装版本、仓库组合
签名密钥或证书错误 准确的源和官方密钥·系统时间·证书验证
缺少可执行文件或文档 安装状态·软件包所有权关系·实际文件差异

如果是锁错误,首先检查是否有其他 DNF·RPM 操作或自动更新正在运行,并等待其完成。不要随意删除锁文件·RPM 数据库或强制终止正常操作作为首选解决方法。

区分名称错误和仓库·依赖问题

在原实验中,特意查询了一个不存在的练习包名以重现以下错误。--assumeno会对安装确认回答no。

sudo dnf --assumeno install lf-course-missing-package-20261112
No match for argument: lf-course-missing-package-20261112
Error: Unable to find a match: lf-course-missing-package-20261112

此时,退出状态为 1。根据错误检查实际的包名和来源。

dnf search tree
dnf info tree
dnf provides /usr/bin/tree
dnf repoquery --requires --resolve tree
sudo dnf --assumeno install tree

在相同的环境中,tree 被确认作为 BaseOS 中 2.1.0-8.el10.x86_64 的候选项,并且有一个安装计划。此比较是为了区分错误使用的名称和正常候选项。如果所需的软件包仅存在于附加软件仓库中,请使用 软件仓库指南 检查其作用、启用状态和支持的组合。仅仅纠正名称不能解决所有依赖冲突。

对于 nothing provides,确定缺失的库或功能以及需要它的包。检查操作系统主要版本、仓库兼容性以及冲突的候选项。不要通过 RPM 的 --nodeps 绕过依赖,不要禁用签名验证,也不要随意应用 DNF 的 --allowerasing。批准解决方案前,请审查每一个建议的移除操作及其影响的服务。

根据你已确定的原因进行缓存清理。

如果列表过旧或由于缓存限制无法查询,首先从当前仓库重新检查元数据。

sudo dnf --refresh info tree

在 包搜索操作 中,由于缺少 dnf -C provides 所需文件列表的缓存,查询失败,但当排除 -C 并执行正常查询时,必要的信息被获取。仅使用缓存查询失败与仓库中缺少该包是不同的问题。

请参阅 DNF 官方命令 ,其中 clean expire-cache 使缓存的元数据过期以进行重新验证,clean metadata 移除其元数据以便稍后可以再次下载,clean all 一次清理多个缓存。因此,如果每次都清理整个缓存,你可能只会增加下载量而无法解决根本原因。

如果已确认元数据损坏且需要清理,可按需执行sudo dnf clean metadata,再通过正常仓库访问重新查询。对于本文中的实践,普通缓存未被故意删除,软件仓库或证书验证也没有被削弱。

使用 RPM 查找丢失的文件并通过重新安装进行恢复。

查询所有者和验证安装文件是不同的任务。rpm -qf 用于查找所属的软件包,而 rpm -V 将安装数据库中记录的属性与当前文件进行比较。其含义也可以在 RPM 官方命令参考 中确认,原课程在该虚拟机的RPM 4.19.1.1上测试过以下步骤。

以下复现仅在没有工作数据的专用虚拟机上进行。已经使用 tree 的服务器上不会故意移动文件。首先,查看安装计划,安装 tree,并记录实际的安装事务 ID。

sudo dnf --assumeno install tree
sudo dnf install tree
sudo dnf history info last
rpm -qf /usr/share/doc/tree/README
rpm -V tree

此虚拟机在本次会话的安装 ID 为 6,并且安装了一个 tree。其他电脑上的 ID 不同。下面的复现只移动属于此软件包的一个 README 文档,而不是可执行文件或服务设置。如果它不是预期的版本、文档或新的备份位置,在进行更改前请停止。

sudo bash <<'BASH'
set -eu
test "$(rpm -qf /usr/share/doc/tree/README)" = tree-2.1.0-8.el10.x86_64
test -f /usr/share/doc/tree/README
test ! -e /root/lf-course-12-before
mkdir -m 700 /root/lf-course-12-before
mv -- /usr/share/doc/tree/README /root/lf-course-12-before/tree-README
BASH
rpm -V tree
printf 'verify exit=%s\n' "$?"

如果您的版本不同或备份文件夹已存在,不要删除上述条件检查来强行继续。请再次验证文件路径和练习准备状态。在此虚拟机上,已确认以下结果和退出状态1。

missing   d /usr/share/doc/tree/README

missing表示安装数据库记录的文件在实际路径中缺失,而 d 表示一个文档文件。rpm -V 仅报告问题,并不会恢复该文档的内容。请检查实际的更改或遗漏是否是有意的,然后阅读重新安装计划。

sudo dnf --assumeno reinstall tree
sudo dnf reinstall tree
sudo cmp /root/lf-course-12-before/tree-README /usr/share/doc/tree/README
rpm -V tree
printf 'verify exit=%s\n' "$?"

此操作重新安装了 BaseOS 的相同版本tree。恢复的文档与备份完全相同,cmp 结束时没有任何差异,RPM 验证也返回 0 且没有输出。要重新安装,您必须从源获取当前安装的确切版本的 RPM。配置文件可以根据软件包替换策略单独处理,因此总是将操作设置覆盖为原始设置的命令并不通用。

如果重新安装失败且文档仍然丢失,您可以将本操作中制作的备份 /root/lf-course-12-before/tree-README 复制到原始路径 /usr/share/doc/tree/README,同时保留属性,然后再次进行验证。即便如此,首先检查目标是否确实丢失,以避免覆盖其他更改。由于此次实际恢复成功,因此重新复制备份的操作路径未被执行。

请同时阅读历史栏目和详细记录。

sudo dnf history list tree
sudo dnf history info last

此安装记录的 ID 为 6,重新安装的记录 ID 为 7。重新安装的操作为 R,Altered 为 2,但详细列表中的 Reinstall 和 Reinstalled 是同一tree软件包的替换操作。将 Altered 2 解释为安装了两个不同的程序会得出错误的结论。

需要检查的项目 需要解释的内容
ID · 命令行 · 时间 何时执行了哪个命令,以及它是否与当前正在调查的更改相符
操作 执行的操作类型,例如安装、升级、删除、重新安装
已更改 · 附加符号 更改操作次数及附加状态提示。与详细的软件包列表进行比较
返回代码 · 已更改的软件包 结果状态及实际更改的软件包 · 版本 · 来源
脚本输出 在安装或删除过程中执行的软件包脚本留下的指引或警告

Altered 的 * 列可能表示未完成的事务,# 表示以非零状态结束的任务,E 可能表示成功完成但有警告或错误输出。在实际过去的 EPEL 安装历史中,E 标记也可见,但详细的返回码是 Success,并且可以检查脚本指导。不要仅根据一个符号就得出整体安装失败或受损的结论。

数据库状态指示器如 < 和 > 还提供了比较前后操作及完整历史的线索。不要仅仅查看按包名过滤的列表;如有必要,请检查整个 sudo dnf history list 和相关 ID 的详细记录。不要假设失败的命令会像成功事务那样记录在历史记录中;原始错误输出也应保留。

撤销一个已验证的安装事务

此练习回滚在最初未安装该tree的虚拟机上执行的单个tree的安装。同时,创建一个用户备注以检查其是否保持与包任务分开。如果存在同名文件,不要覆盖它;使用不同的新实践路径。

test ! -e ~/history-lab-note.txt && printf 'keep my notes\n' > ~/history-lab-note.txt
cat ~/history-lab-note.txt
sudo dnf history list tree

在列表中,找到此实验室的独立tree安装事务。 使用其实际ID,而不是原实验的示例值6。

read -r -p 'Verified tree installation ID: ' TXID
if [[ "$TXID" =~ ^[1-9][0-9]*$ ]]; then
    sudo dnf history info "$TXID"
    sudo dnf --assumeno history undo "$TXID"
else
    printf 'Enter a positive numeric transaction ID. Stop and check the history.\n' >&2
    unset TXID
fi

检查详细记录是否显示了预期的安装以及回滚计划中仅包含要移除的tree。如果包含其他程序或配置包,或如果是启动时已使用的tree,则不予批准。此虚拟机ID为6的回滚计划为 Remove 1 Package 和tree,并在审核后应用。

sudo dnf history undo "${TXID:?Read and verify a positive numeric transaction ID first}"
rpm -q tree
cat ~/history-lab-note.txt
sudo dnf history info last
sudo dnf check

在实际结果中,tree返回到未安装状态,ID为8的回滚操作仍显示为成功。用户笔记keep my notes保持不变。也就是说,执行了安装的反向操作,但用户创建的文件不会恢复到过去。检查完成后,仅使用以下命令删除自己创建的练习笔记:rm -- ~/history-lab-note.txt。

原课程记录的测试仅撤销了已验证的单包tree安装。之前的EPEL设置、操作系统更新和其他事务没有一起回滚,也没有执行完整的服务器回滚。实际上,现有的仓库文件、SSH、SELinux强制模式和最新运行的内核都被保留。

区分撤销、重做和回滚的范围及恢复限制。

历史任务 范围和注意事项
history undo ID 尝试执行指定事务中包含的操作的逆向操作。
history redo ID 在当前状态下重试指定事务的操作。
history rollback ID 由于这是回滚指定ID之后多个事务的范围,其影响比撤销单个操作更广泛。

历史命令受当前安装状态和软件包可用性的限制。如果当时的版本已从仓库中消失或依赖关系发生变化,可能无法回滚。仅仅存在旧的 DNF ID 并不意味着用于恢复的 RPM 和服务数据已经被保留。

由软件包脚本、数据库模式、用户数据以及直接修改的配置所做的外部更改必须通过应用程序的恢复程序和备份来处理。特别是在回滚核心操作系统软件包或大规模更新到单个版本号之前,应审查支持的恢复方法和潜在影响。此次练习中小规模的软件包撤销成功,并不保证在所有服务器上都能恢复。

问题解决的完成标准不仅仅是错误信息是否消失。您需要检查目标包、版本、文件和依赖状态是否正确,受影响的服务和数据是否正常,并记录实际进行了哪些更改。