三、症状
执行 dnf install 或 yum install 时出现网络连接失败或超时错误。
四、排查步骤
步骤 1：测试网络连通性
ping mirrors.tencentyun.com -c 3
如果 ping 失败或解析异常，请检查 DNS 配置：
cat /etc/resolv.conf# 确保 nameserver 配置正确
步骤 2：检查防火墙和安全组
# 检查本地防火墙firewall-cmd –list-all# 检查 HTTP 访问curl -I http://mirrors.tencentyun.com/tlinux/
步骤 3：验证 YUM 源
dnf repolistdnf makecache
六、症状
执行 dnf makecache 或 dnf repolist 同步软件源缓存时，出现类似以下的报错：
Error: Failed to synchronize cache for repo '…'
七、解决方案
检查 /etc/yum.repos.d 目录：
ls /etc/yum.repos.d/
TencentOS Server 系统自带的标准 repo 文件：
| 系统版本 | 标准 repo 文件 |
| TencentOS Server 3 | TencentOS.repo、epel.repo |
| TencentOS Server 4 | TencentOS.repo、epol.repo |
注意：如果目录中存在第三方 repo 文件，可能导致软件源冲突。
移除非系统标准 repo 文件：
# 备份现有 repo 文件mkdir -p /etc/yum.repos.d/backupmv /etc/yum.repos.d/*.repo /etc/yum.repos.d/backup/# 查看系统版本cat /etc/os-release# 重新配置标准源（TencentOS Server 4，与系统默认配置一致）cat > /etc/yum.repos.d/TencentOS.repo << 'EOF'[BaseOS]name=TencentOS Server $releasever – BaseOSbaseurl=http://mirrors.tencentyun.com/tlinux/$releasever/BaseOS/$basearch/os/ http://mirrors.tencent.com/tlinux/$releasever/BaseOS/$basearch/os/gpgcheck=1enabled=1gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4[AppStream]name=TencentOS Server $releasever – AppStreambaseurl=http://mirrors.tencentyun.com/tlinux/$releasever/AppStream/$basearch/os/ http://mirrors.tencent.com/tlinux/$releasever/AppStream/$basearch/os/gpgcheck=1enabled=1gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4[extras]name=TencentOS Server $releasever – extrasbaseurl=http://mirrors.tencentyun.com/tlinux/$releasever/extras/$basearch/os/ http://mirrors.tencent.com/tlinux/$releasever/extras/$basearch/os/gpgcheck=1enabled=1gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4EOF
清除缓存并重试：
dnf clean alldnf makecache
九、症状
安装软件包时，出现类似以下的报错（其中 <package-name> 为实际的软件包名）：
No match for argument: <package-name>Error: Unable to find a match
十、排查步骤
步骤 1：确认系统版本
cat /etc/os-release
步骤 2：在镜像站查询软件包
访问 镜像站 对应版本目录，搜索软件包是否存在。
步骤 3：搜索正确的包名
# 搜索软件包（模糊匹配）dnf search <关键词># 查询哪个包提供了某个命令或文件dnf provides /usr/bin/curldnf provides "*/libssl.so*"
步骤 4：启用额外软件源
# TencentOS Server 4：启用 EPOL（EPEL 的 TencentOS 适配版，标准镜像默认已安装）dnf install -y epol-release# 确认 EPOL 源配置文件存在ls /etc/yum.repos.d/epol.repo# 对于第三方软件（如 Docker），可添加 repodnf config-manager –add-repo https://download.docker.com/linux/centos/docker-ce.repo
十二、症状
执行 dnf 或 yum 命令时，出现类似以下的报错，或命令完全无法执行：
SyntaxError: invalid syntax
十三、原因
用户修改了系统默认 Python 版本（/usr/bin/python 软链接），导致 dnf/yum 脚本使用了错误的 Python 解释器。
十四、解决方案
TencentOS Server 4（使用 Python 3）：
# 检查 /usr/bin/dnf 的 shebang 行head -1 /usr/bin/dnf# 应该是 #!/usr/bin/python3# 如果不对，修复它sed -i '1s|.*|#!/usr/bin/python3|' /usr/bin/dnf
TencentOS Server 3（使用 Python 3）：
head -1 /usr/bin/dnf# 应该是 #!/usr/bin/python3
建议：系统 Python 版本应通过 python3 命令访问，不要修改 /usr/bin/python 软链接。如需管理多个 Python 版本，使用 pyenv：
# 使用 pyenv 管理 Python 版本（不影响系统 Python）curl https://pyenv.run | bashpyenv install 3.11.0pyenv global 3.11.0
十六、症状
安装或升级软件包时，出现类似以下的依赖冲突报错：
Error: Problem: package X requires Y, but none of the providers can be installed
十七、解决方案
# 查看依赖关系dnf deplist <package-name># 查看冲突原因dnf install –best <package-name># 跳过损坏的依赖（不推荐，可能导致系统不稳定）dnf install –skip-broken <package-name># 尝试直接下载 RPM 并安装（忽略 repo 依赖）dnf download <package-name>rpm -ivh –nodeps <package>.rpm
十九、症状
安装软件包时，出现类似以下的报错：
GPG key retrieval failed
20、解决方案
# 临时跳过 GPG 验证（调试用）dnf install –nogpgcheck <package-name># 导入腾讯 GPG 密钥（系统内置）rpm –import /etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4# 在 repo 文件中永久跳过 GPG（不推荐，降低安全性）# gpgcheck=0
22、症状
安装软件包或执行 dnf 相关操作时，出现类似以下的报错：
OSError: [Errno 28] No space left on device
23、解决方案
# 查看磁盘使用情况df -h# 清理 dnf 缓存dnf clean all# 缓存位置：/var/cache/dnf/# 清理旧内核（保留当前和上一个版本）dnf remove $(dnf repoquery –installonly –latest-limit=-2 -q)# 查看大文件du -sh /var/cache/dnf/
24、常用 DNF 命令速查
# 安装软件包dnf install -y <package-name># 更新所有软件包dnf update -y# 更新单个软件包dnf update -y <package-name># 删除软件包dnf remove <package-name># 搜索软件包dnf search <keyword># 查看软件包信息dnf info <package-name># 列出已安装的软件包dnf list installed# 查看软件包更新历史dnf history# 回滚到上一次 dnf 操作dnf history undo last# 清理缓存dnf clean all# 仅下载不安装dnf download <package-name>dnf download –resolve –alldeps <package-name> # 含所有依赖