常见错误速查
本页收录了 EL 系统（AlmaLinux、Rocky Linux、CentOS 等）日常管理中最常见的错误信息及其解决方案，按类别组织，方便快速查找。
”No match for argument: xxx”
Section titled “”No match for argument: xxx””软件包不在已启用的仓库中。
$ dnf search <关键词>$ sudo dnf install -y epel-release$ dnf search <包名>“This command has to be run with superuser privileges”
Section titled ““This command has to be run with superuser privileges””需要 root 权限。在命令前加 sudo。
$ sudo dnf install <包名>如果用户不在 sudoers 列表中：
$ su -# usermod -aG wheel <用户名>“Error: Failed to download metadata for repo ‘xxx’”
Section titled ““Error: Failed to download metadata for repo ‘xxx’””仓库元数据下载失败。可能是网络问题或仓库 URL 过期。
$ sudo dnf clean all$ sudo dnf makecache$ cat /etc/yum.repos.d/<仓库名>.repo$ sudo dnf config-manager --set-disabled <仓库ID># EL10 的包管理器仍是 DNF 4（4.20），这条写法可用；只有将来切到 DNF 5 才需要改成 disable <repo> 子命令对于已 EOL 的 CentOS 8，官方仓库已下线。需要迁移到 AlmaLinux 或 Rocky Linux。
“Error: Transaction check error: file xxx from install of yyy conflicts with file from package zzz”
Section titled ““Error: Transaction check error: file xxx from install of yyy conflicts with file from package zzz””软件包文件冲突。
$ sudo dnf install <包名> --allowerasing$ rpm -ql <包1> | sort > /tmp/pkg1.txt$ rpm -ql <包2> | sort > /tmp/pkg2.txt$ comm -12 /tmp/pkg1.txt /tmp/pkg2.txt“Curl error (28): Timeout was reached”
Section titled ““Curl error (28): Timeout was reached””下载超时。网络问题或镜像站不可达。
$ curl -I https://mirror.example.com/$ sudo sed -i 's|^mirrorlist=|#mirrorlist=|g' /etc/yum.repos.d/almalinux*.repo$ sudo sed -i 's|^# baseurl=https://repo.almalinux.org|baseurl=https://mirrors.aliyun.com|g' /etc/yum.repos.d/almalinux*.repo$ sudo dnf makecache“Protected multilib versions: xxx”
Section titled ““Protected multilib versions: xxx””32 位和 64 位版本的同一软件包版本不一致。
$ sudo dnf distro-sync <包名>$ sudo dnf remove <包名>.i686服务管理错误
Section titled “服务管理错误””Job for xxx.service failed because the control process exited with error code”
Section titled “”Job for xxx.service failed because the control process exited with error code””服务启动失败。
$ systemctl status <服务名>$ journalctl -u <服务名> -n 50 --no-pager$ nginx -t$ httpd -t“Unit xxx.service is masked”
Section titled ““Unit xxx.service is masked””服务被屏蔽，无法启动。
$ sudo systemctl unmask <服务名>$ sudo systemctl start <服务名>“xxx.service: Failed with result ‘exit-code’”
Section titled ““xxx.service: Failed with result ‘exit-code’””服务启动后异常退出。
$ systemctl show <服务名> -p ExecMainStatus$ journalctl -u <服务名> -e --no-pager常见原因：配置文件语法错误、端口被占用、权限不足、依赖服务未启动。
$ sudo ss -tlnp | grep :<端口号>“Failed to start xxx.service: Unit not found”
Section titled ““Failed to start xxx.service: Unit not found””服务单元文件不存在。
$ rpm -qa | grep <包名>$ systemctl list-unit-files | grep <关键词>SELinux 错误
Section titled “SELinux 错误””Permission denied” 但文件权限正确
Section titled “”Permission denied” 但文件权限正确”最常见的 SELinux 问题。文件的 Unix 权限正确，但 SELinux 安全上下文不匹配。
$ sudo ausearch -m avc -ts recent$ sudo dnf install -y setroubleshoot-server$ sudo sealert -a /var/log/audit/audit.log | head -60$ sudo restorecon -Rv /path/to/files“SELinux is preventing xxx from yyy access on zzz”
Section titled ““SELinux is preventing xxx from yyy access on zzz””SELinux 策略阻止了某个操作。
$ sudo ausearch -m avc -ts recent | audit2why$ sudo ausearch -m avc -ts recent | audit2allow -M my_policy$ sudo semodule -i my_policy.pp非标准端口被 SELinux 阻止
Section titled “非标准端口被 SELinux 阻止”例如将 Apache 配置为监听 8888 端口：
$ sudo semanage port -l | grep http_port_t$ sudo semanage port -a -t http_port_t -p tcp 8888Web 服务无法访问用户主目录内容
Section titled “Web 服务无法访问用户主目录内容”$ sudo setsebool -P httpd_enable_homedirs on$ sudo setsebool -P httpd_can_network_connect on”Network is unreachable”
Section titled “”Network is unreachable””没有到达目标的路由。
$ ip route show$ ip route show default如果没有默认路由：
$ sudo ip route add default via <网关IP>$ sudo nmcli connection modify "连接名" ipv4.gateway <网关IP>$ sudo nmcli connection up "连接名"“Connection refused”
Section titled ““Connection refused””目标端口没有服务在监听。
$ sudo ss -tlnp | grep :<端口>$ systemctl status <服务名>“Name or service not known”
Section titled ““Name or service not known””DNS 解析失败。
$ cat /etc/resolv.conf$ ping -c 2 $(grep nameserver /etc/resolv.conf | head -1 | awk '{print $2}')$ dig @8.8.8.8 <域名>“bind: Address already in use”
Section titled ““bind: Address already in use””端口已被其他进程占用。
$ sudo ss -tlnp | grep :<端口>$ sudo lsof -i :<端口>$ sudo kill <PID>”No space left on device”
Section titled “”No space left on device””磁盘空间不足。
$ df -h$ sudo du -sh /* 2>/dev/null | sort -rh | head -10$ sudo dnf clean all$ sudo journalctl --vacuum-size=100M$ sudo find /tmp -type f -atime +7 -delete如果 df -h 显示还有空间但仍报错：
$ df -iinode 耗尽通常是某个目录下有大量小文件：
$ sudo find / -xdev -printf '%h\n' | sort | uniq -c | sort -rn | head -10“Structure needs cleaning” / 文件系统错误
Section titled ““Structure needs cleaning” / 文件系统错误”文件系统损坏。
$ sudo umount /dev/sda2$ sudo fsck -y /dev/sda2警告： 绝对不要在已挂载的文件系统上运行 fsck。如果是根分区，需要从救援模式操作。
“Read-only file system”
Section titled ““Read-only file system””文件系统被强制切换为只读模式，通常是检测到磁盘错误。
$ dmesg | grep -i -E '(error|fail|read.only|EXT4-fs)'$ sudo mount -o remount,rw /如果无法重新挂载，说明磁盘有硬件问题，需要从救援模式修复。
“/boot 空间不足导致内核安装失败”
Section titled ““/boot 空间不足导致内核安装失败””$ df -h /boot$ rpm -qa kernel-core | sort -V$ sudo dnf remove --oldinstallonly --setopt installonly_limit=2 kernel”Operation not permitted”（即使是 root）
Section titled “”Operation not permitted”（即使是 root）”可能是文件设置了不可变属性。
$ lsattr <文件路径>如果看到 i 标志（immutable）：
$ sudo chattr -i <文件路径>“xxx: command not found”
Section titled ““xxx: command not found””命令不在 PATH 中，或者对应的软件包未安装。
$ dnf provides <命令名>$ /usr/sbin/<命令名>$ echo $PATH“cannot create regular file: Permission denied”
Section titled ““cannot create regular file: Permission denied””$ ls -la <目标目录>$ ls -laZ <目标目录>$ getfacl <目标目录>SSH 相关错误
Section titled “SSH 相关错误””WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!”
Section titled “”WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!””服务器密钥发生变化（常见于重装系统或迁移后）。
$ ssh-keygen -R <主机名或IP>“Permission denied (publickey,gssapi-keyex,gssapi-with-mic)”
Section titled ““Permission denied (publickey,gssapi-keyex,gssapi-with-mic)””密钥认证失败，且服务端禁用了密码认证。
$ sudo grep -E '(PasswordAuthentication|PubkeyAuthentication|PermitRootLogin)' /etc/ssh/sshd_config$ ls -la ~/.ssh/$ chmod 700 ~/.ssh$ chmod 600 ~/.ssh/id_rsa$ chmod 644 ~/.ssh/id_rsa.pub$ chmod 700 ~/.ssh$ chmod 600 ~/.ssh/authorized_keys