宝塔面板安装PHP 7.4卡在系统检测环节，本质是CentOS 8等EOL系统软件源失效导致gcc-c++等硬性依赖无法安装，需先切换至vault镜像源、启用powertools、安装Development Tools及libjpeg-devel/sqlite-devel等关键包，并清除宝塔检测缓存后重启服务。
宝塔面板安装PHP 7.4时卡在系统检测环节，提示“环境不满足”或直接退出安装流程，说明底层依赖缺失已触发宝塔自检机制拦截，不是界面假死，而是编译链在configure前就被终止。
确认系统是否仍在维护周期内
执行 cat /etc/redhat-release 或 lsb_release -a 查看系统版本。若为 CentOS 8、Rocky Linux 8 或 AlmaLinux 8，且当前日期晚于2021年12月31日，则【官方软件源已失效】——宝塔调用 yum install 时会反复尝试连接 mirror.centos.org，最终超时失败，检测直接返回 false。
CentOS 7 用户跳过此步；Ubuntu/Debian 系统无需处理源失效问题。
修复失效的系统软件源（CentOS 8/Rocky/AlmaLinux 8专属）
第一步：备份原仓库配置cp -r /etc/yum.repos.d /etc/yum.repos.d.bak
第二步：清空旧源并启用镜像站rm -f /etc/yum.repos.d/CentOS-*.repocurl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-vault-8.5.2111.repo
第三步：启用 PowerTools（关键！否则 gcc-c++ 无法安装）dnf config-manager --set-enabled powertools
第四步：重建缓存并验证dnf clean all && dnf makecache
运行 dnf list available gcc-c++，能列出结果即成功。若仍报错“Failed to download metadata”，说明镜像地址已变更，需改用清华或腾讯云镜像源。
补全PHP编译硬性依赖
方法一：一键安装基础工具链（推荐）yum groupinstall "Development Tools" -y
方法二：精准安装缺失项（适用于最小化安装系统）yum install -y gcc gcc-c++ make autoconf libtool pcre-devel openssl-devel curl-devel libxml2-devel freetype-devel libjpeg-devel libpng-devel sqlite-devel bzip2-devel gmp-devel oniguruma-devel
注意：libjpeg-devel 和 sqlite-devel 是PHP 7.4编译阶段最常触发检测失败的两个包，缺一不可。CentOS 8 安装 sqlite-devel 前必须先启用 powertools，否则提示“No match for argument”。
立即学习“PHP免费学习笔记（深入）”；
强制刷新宝塔内置检测缓存
宝塔面板会缓存一次检测结果，即使你刚装完所有依赖，它仍可能沿用旧判断。
执行以下命令清除检测状态：rm -f /www/server/panel/data/php_check.plrm -f /www/server/panel/data/install.pl
然后重启宝塔服务：bt restart
此时再进软件商店安装 PHP 7.4，系统检测将重新执行，不再读取缓存结果。
