阿里云服务器CentOS8.0执行yum命令出现“Error: Failed to synchronize cache for repo ‘AppStream‘”问题解决方案

原创 于 2026-04-10 23:40:24 发布 · 2.7k 阅读 · 9 ·
本内容遵循CC 4.0 BY-SA版权协议
版权©️猫头虎技术团队
GEO检测
标签
#阿里云 #服务器 #云计算 #运维 #开源
#开发语言 #java

阿里云服务器CentOS8.0执行yum命令出现“Error: Failed to synchronize cache for repo ‘AppStream‘”问题解决方案

摘要

本文将详细解析在阿里云服务器 CentOS 8.0 系统中，执行 yum 命令时遇到 Error: Failed to synchronize cache for repo 'AppStream' 错误的根本原因及完整解决方案。该问题主要源于 CentOS 8 已于 2021 年 12 月 31 日停止维护（EOL），官方镜像源被移除，导致 yum 无法同步仓库缓存。

本文开发场景：在阿里云 ECS 服务器（CentOS 8.0）上尝试安装软件包（如 wget）或更新系统时，yum 命令报错。通过修改 YUM 仓库配置文件，将失效的镜像源地址替换为 阿里云 Vault 镜像 或 CentOS Vault 归档源，即可恢复 yum 正常使用。文章将提供手动修改和自动化脚本两种方法，并扩展其他常见解决方案。

关键词：CentOS 8 EOL、AppStream 错误、yum 换源、阿里云服务器、Vault 镜像

文章目录

CentOS8 yum 修复过程示意

开发环境

  • 云服务商：阿里云 ECS
  • 操作系统：CentOS Linux release 8.0.1905 (Core)
  • 包管理工具：yum 4.x
  • 问题触发命令：yum install <package> 或 yum makecache

一、核心问题：CentOS 8 官方源停止维护（EOL）

1.1 问题现象

在阿里云 CentOS 8.0 服务器上执行任意 yum 命令（如 yum install wget），报错如下：

Error: Failed to synchronize cache for repo 'AppStream'

或伴随其他类似错误：

Cannot prepare internal mirrorlist: No URLs in mirrorlist

1.2 根本原因

  • CentOS 8 生命周期终止（End of Life, EOL）：2021 年 12 月 31 日，CentOS 官方停止维护 CentOS 8，并移除了所有官方镜像源。
  • 阿里云默认源同步失效：阿里云的 CentOS 8 镜像源（如 mirrors.cloud.aliyuncs.com）也同步关闭，导致 yum 无法访问仓库 URL。
  • AppStream 仓库报错：AppStream 是 CentOS 8 的核心应用流仓库，其源失效直接导致 yum 无法工作。

引用官方公告：CentOS 8 已结束生命周期，用户应迁移至 CentOS Stream 8/9 或其他 RHEL 兼容发行版。对于仍需使用旧版本的用户，必须使用 Vault 归档源。

二、解决方案全景图

下面用 Mermaid 序列图展示从报错到修复完成的决策流程：

新镜像源(Vault) /etc/yum.repos.d/ yum 命令 开发者 新镜像源(Vault) /etc/yum.repos.d/ yum 命令 开发者 yum install wget 读取 .repo 文件 旧的 baseurl/mirrorlist 尝试连接旧源(阿里云/官方) ❌ 404/超时 Error: Failed to sync cache for 'AppStream' 决策: 修改仓库源至 Vault vim CentOS-*.repo 替换 baseurl 为 vault.centos.org yum clean all && yum makecache 连接 Vault 镜像源 ✅ 正常响应 成功安装软件包

2.1 方案一（推荐）：手动修改仓库配置文件

步骤 1：进入 YUM 仓库目录
cd /etc/yum.repos.d/
步骤 2：备份原有配置文件
mkdir backup
cp CentOS-*.repo backup/
步骤 3：修改关键仓库文件

需要修改以下文件中的 baseurl 行（如果存在 mirrorlist 行，请注释或删除）：

  • CentOS-AppStream.repo
  • CentOS-Base.repo
  • CentOS-Extras.repo
  • CentOS-PowerTools.repo（如果存在）

以 CentOS-AppStream.repo 为例，修改后的内容如下：

[AppStream]
name=CentOS-$releasever - AppStream
baseurl=http://vault.centos.org/centos/8/AppStream/$basearch/os/
gpgcheck=1
enabled=1
gpgkey=http://vault.centos.org/centos/RPM-GPG-KEY-CentOS-Official

同样修改 CentOS-Base.repo：

[base]
name=CentOS-$releasever - Base
baseurl=http://vault.centos.org/centos/8/BaseOS/$basearch/os/
gpgcheck=1
enabled=1
gpgkey=http://vault.centos.org/centos/RPM-GPG-KEY-CentOS-Official

修改 CentOS-Extras.repo：

[extras]
name=CentOS-$releasever - Extras
baseurl=http://vault.centos.org/centos/8/extras/$basearch/os/
gpgcheck=1
enabled=1
gpgkey=http://vault.centos.org/centos/RPM-GPG-KEY-CentOS-Official

提示：$basearch 变量会自动替换为系统架构（如 x86_64），$releasever 会自动替换为 8。

步骤 4：清理 YUM 缓存并重新生成
yum clean all
yum makecache
步骤 5：测试安装
yum install wget -y

2.2 方案二：使用阿里云 Vault 镜像（国内更快）

将 baseurl 中的 vault.centos.org 替换为阿里云 Vault 镜像：

baseurl=http://mirrors.aliyun.com/centos-vault/8.5.2111/AppStream/$basearch/os/

注意：阿里云 Vault 镜像需要指定具体版本号（如 8.5.2111），可替换为其他 8.x 版本。

2.3 方案三：使用 sed 一键批量替换（自动化脚本）

对于多台服务器，可使用以下脚本快速修复：

cd /etc/yum.repos.d/
sed -i 's/mirrorlist/#mirrorlist/g' CentOS-*.repo
sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' CentOS-*.repo
yum clean all && yum makecache

解释：

  • 第一条命令：注释掉所有 mirrorlist 行
  • 第二条命令：将 #baseurl=http://mirror.centos.org 替换为 baseurl=http://vault.centos.org（注意 # 位置）

2.4 方案四：直接禁用 AppStream 仓库（不推荐）

如果仅需基础仓库，可以禁用 AppStream（但会导致某些软件无法安装）：

yum-config-manager --disable AppStream

三、扩展：其他常见 YUM 源问题及解决方案

除了 CentOS 8 EOL 问题，以下场景也可能导致 yum 报错。下表总结了典型问题及对策：

错误现象常见原因解决方案
Error: Failed to synchronize cache for repo 'AppStream'CentOS 8 EOL，官方源失效改用 Vault 归档源（如 vault.centos.org）
[Errno 14] HTTP Error 404 - Not Found仓库 URL 中路径错误或版本号不存在检查 baseurl 中的版本号是否有效（如 8.5.2111），或使用 $releasever 变量
GPG key retrieval failedGPG 密钥地址失效将 gpgkey 也指向 Vault 源：http://vault.centos.org/centos/RPM-GPG-KEY-CentOS-Official
Cannot find a valid baseurl for repo: base网络问题或 DNS 解析失败① 检查网络连通性 ping vault.centos.org ② 修改 DNS 为 8.8.8.8 ③ 临时使用 --nogpgcheck 跳过验证
YUM lock file exists之前 yum 进程未正常退出rm -f /var/run/yum.pid
No package xxx available软件包不在当前启用的仓库中① 启用 EPEL 仓库：yum install epel-release ② 使用 yum search 查找

3.1 网络与 DNS 问题排查

如果修改源后仍然超时，请检查 DNS 配置：

# 测试能否解析 vault.centos.org
nslookup vault.centos.org

# 临时修改 DNS
echo "nameserver 8.8.8.8" >> /etc/resolv.conf

3.2 EPEL 仓库同样需要适配

如果使用 EPEL 仓库，其配置文件 /etc/yum.repos.d/epel.repo 也需修改：

[epel]
name=Extra Packages for Enterprise Linux $releasever - $basearch
baseurl=http://vault.centos.org/centos/8/extras/$basearch/os/
enabled=1
gpgcheck=0   # 或者设置正确的 gpgkey

3.3 彻底迁移至 CentOS Stream 8

作为长期方案，建议将系统迁移到 CentOS Stream 8（仍受支持）：

dnf install centos-release-stream
dnf swap centos-{linux,stream}-repos
dnf distro-sync

注意：迁移前务必备份数据，并验证业务兼容性。

四、问题解决流程图（Mermaid Graph）

国际用户

国内用户

是

否

yum 命令报错 AppStream

检查 /etc/yum.repos.d/

备份原有 .repo 文件

修改 baseurl 或 mirrorlist

选择镜像源类型

使用 vault.centos.org

使用 mirrors.aliyun.com/centos-vault

yum clean all

yum makecache

是否成功？

✅ 正常安装软件

检查网络/DNS/GPG密钥

手动测试 baseurl 是否可访问

五、总结与最佳实践

  1. CentOS 8 已停更，尽早规划迁移：CentOS 8 用户应计划迁移到 Rocky Linux、AlmaLinux 或 CentOS Stream 8/9。
  2. 归档源仅适用于临时维护：Vault 源不再更新软件包，不适合长期生产环境。
  3. 修改前务必备份：cp /etc/yum.repos.d/*.repo /tmp/ 防止配置错误导致无法恢复。
  4. 优先使用自动化脚本：对于批量服务器，使用 sed 或 Ansible 统一修改。
  5. 阿里云用户可联系售后获取镜像支持：部分阿里云 CentOS 8 实例可通过后台一键修复。

温馨提示🔔 更多Bug解决方案请查看 ==> 全栈Bug解决方案专栏

作者✍️名片

CSDN猫头虎万粉变现计划和账号流量诊断服务名片

阿里云服务器CentOS8.0执行yum命令出现“Error: Failed to synchronize cache for repo ‘AppStream‘”问题解决
KevinzzzzZ的博客
04-06 3221
当执行yum命令出现如下的情况： 解决方法： 1.进入到/etc/yum.repos.d目录里面。 2.分别修改CentOS-AppStream.repo、CentOS-Base.repo、CentOS-Extras.repo、CentOS-PowerTools.repo文件中的baseurl。 CentOS-AppStream.repo # CentOS-AppStream.repo # # The mirror system uses the connecting IP address of the
服务器报错 Error: Failed to synchronize cache for repo ‘AppStream‘
生活很苦，但学习还得继续
03-23 5948
博主最近在学习部署服务器，并且把自己的项目传到服务器上与前端联调 在部署阿里云环境时 (CentOS 8)，用yum 命令安装命令时报错： Error: Failed to synchronize cache for repo ‘AppStream’
yum命令下载出现Failed to synchronize cache for repo ‘AppStream‘, ignoring this repo.
weixin_47120348的博客
02-02 1498
【代码】yum命令下载出现Failed to synchronize cache for repo 'AppStream', ignoring this repo.
centos8.0执行yum指令出现Error:Failed to synchronize cache for repo ‘AppStream‘
qq_35048277的博客
05-09 1807
解决方法：修改/etc/yum.repos.d下的“CentOS-AppStream.repo”“CentOS-Base.repo”“CentOS-Extras.repo”“CentOS-PowerTools.repo”。 # CentOS-AppStream.repo # # The mirror system uses the connecting IP address of the client and the # update status of each mirror to pick m...
Error: Failed to synchronize cache for repo ‘AppStream‘
qq_48959845的博客
03-06 2316
https://zhuanlan.zhihu.com/p/469500685
Centos8 安装软件 Failed to synchronize cache for repo ‘AppStream‘, ignoring this repo.
a205633的博客
06-29 3529
Centos8 yum error 报错
yum时总报错Failed to synchronize cache for repo ‘AppStream‘, ignoring this repo.
qq_45153630的博客
03-14 8647
yum时总报错Failed to synchronize cache for repo 'AppStream', ignoring this repo.
CentOS 下载软件时报Error: Failed to synchronize cache for repo ‘AppStream‘解决方法
最新发布
weixin_44259638的博客
01-17 744
想要下载软件通通失败了，解决方法当然是问AI，按照AI的步骤试了几个小时都还是不行，这台服务器是centos8 和另一台服务器相同目录（）进行了比较发现另一台服务根本没有。的名称改了下，就可以下载软件了，把AI问遍，无人会，解决法。算是瞎猫碰到死耗子吧。
Centos8使用yum提示Error: Failed to synchronize cache for repo ‘AppStream‘
千寻啊千寻
04-21 2332
自2022年1月31日起，CentOS团队从官方镜像中移除CentOS 8的所有包，但软件包仍在官方镜像上保留一段时间。如需继续运行旧CentOS 8，可以在/etc/yum.repos中更新repos.d，使用。一行解开注释，并且修改URL为最新地址。里面有很多源文件，打开文件，注释掉。
解决在CentOS-8中使用yum命令安装软件报错的方法
woshimengxingwjh的博客
03-26 3727
本文用于解决在centos8中使用yum命令安装软件时报错的问题：Error:Failed to synchronize cache for repo ‘AppStream’。 第一步：先检查yum仓库的配置文件是否正确 CentOS-AppStream.repo中的baseurl应该为https://mirrors.aliyun.com/centos/8-stream/AppStream/$basearch/os/ CentOS-Base.repo中的baseurl应该为https://mirrors.
Centos8 安装软件 Failed to synchronize cache for repo 'AppStream', ignoring this repo.
热门推荐
benleng的专栏
11-15 4万+
问题：Centos8安装软件出现 CentOS-8 - AppStream 28 B/s | 38 B 00:01 CentOS-8 - Base 111 B/s | 38 B 00:00 CentOS-8 - Extras 114 B/s | 38 B 00:00 Failed to synchronize cache for repo 'AppStream', ignoring...
Redhat8/CentOS8配置网络源，Failed to synchronize cache for repo ‘LocalRepo_AppStream‘, ignoring this repo.
游吟焰火的博客
01-24 6252
问题 在Redhat8中yum安装gtk发生错误。 [root@localhost ~]# yum install gtk2-devel.x86_64 Updating Subscription Management repositories. Unable to read consumer identity This system is not registered to Red Hat Subscription Management. You can use subscription-manager
阿里云centos8安装报Failed to synchronize cache for repo ‘AppStream‘
fuleigang的专栏
03-29 1404
\Repository AppStream is listed more than once in the configuration Repository extras is listed more than once in the configuration Repository PowerTools is listed more than once in the configuration Repository centosplus is listed more than once in the co
有效解决CentOS 8 AppStream报错以及makecache报错等问题
Sun_study的博客
03-04 1787
解决CentOS8 AppStream报错以及makecache报错等问题 1.备份 使用CentOS 8 yum安装java11，遇到一系列问题。 首先备份原有的repo文件 cd /etc/yum.repos.d && mkdir bak && mv *.repo ./bak 看到一些其他教程只修改CentOS-Base.repo这个文件，会出现以下提示 2.换阿里云源 有些教程给出的换源网址已经不能再使用，建议查看官网 https://developer.ali
CentOS 8 最新阿里YUM源
beichen778的博客
03-10 2397
前文：由于CentOS8 已停止服务，相关源已经停止，前期官方自带的源和前期 阿里、清华、网易 等等的源，都已无法再使用，需要更换源。
CentOS8 yum下载 Failed to synchronize cache for repo ‘AppStream‘ No match for argument:xxx
weixin_43993373的博客
05-23 622
CentOS 8操作系统版本结束了生命周期（EOL），Linux社区已不再维护该操作系统版本。 2021年12月31日CentOS 8 EOL。按照社区规则，CentOS 8的源地址http://mirror.centos.org/centos/8/内容已移除 解决方法1 切换阿里云下载源 CentOS8 切换yum阿里云下载源 #备份之前yum源 mkdir /etc/yum.repos.d/back/ mv /etc/yum.repos.d/* /etc/yum.repos.d/back/ # 通过c.
阿里云ECS CentOS重置后报Failed to synchronize cache for repo ‘AppStream‘
qq_30309399的博客
02-14 954
网上的办法如果都解决不了，那么最简单的方法就是换个版本，原本是CentOS8，后来换成CentOS7.9就解决了。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值