宝塔PHP 8.1扩展安装失败主因是底层编译环境缺失或软件源不可达。需检查gcc/make/autoconf等工具链是否就绪，确认/www/server/php/81/src/ext/源码目录存在且完整，验证libzip-devel、hiredis-devel等依赖库已安装，并确保pecl.php.net及download.bt.cn可正常访问。
宝塔面板里点“安装”PHP 8.1 扩展失败，大概率不是面板坏了，而是底层编译环境没配齐，或者软件源连不上——这两类问题占所有失败案例的 80% 以上。
检查系统是否装了基础编译工具链
宝塔调用 phpize、./configure、make 这套流程，但不会帮你装 gcc、make、autoconf 这些。缺一个，configure 就直接报 command not found 或卡死。
- 执行
gcc -v、make -v、pkg-config --version，任一命令报错就得补装 - CentOS/Rocky/AlmaLinux：运行
yum groupinstall "Development Tools"+yum install autoconf automake libtool - Ubuntu/Debian：运行
apt install build-essential autoconf automake pkg-config - 别信“我刚重装过系统肯定有”，某些最小化镜像连
tar都不带
确认 PHP 源码目录是否存在且完整
宝塔编译扩展时，会去 /www/server/php/81/src/ext/ 找 zip、redis 这类扩展的 C 源码。如果这个路径下是空的，或压根没有 src 目录，编译必然失败——因为没源码可编。
- 进终端执行
ls -l /www/server/php/81/src/，看有没有main/、Zend/、ext/这几个关键子目录 - 如果没有，说明当初安装 PHP 时没勾选“编译安装”或没保留源码；此时不能硬编，得重装 PHP（软件商店 → PHP 8.1 → 卸载 → 重新安装 → 勾选“编译安装”）
- 别试图从别的 PHP 版本拷
src目录过来，API 版本不一致会导致编译通过但运行崩溃
验证 libzip、hiredis 等扩展依赖库是否就位
zip 扩展依赖 libzip，redis 依赖 hiredis，imagick 依赖 libjpeg……这些不是 PHP 自带的，得系统级安装。configure 报 checking for xxx.h not found 就是它们没装好。
立即学习“PHP免费学习笔记（深入）”；
- 查 zip 失败？运行
pkg-config --modversion libzip，没输出就说明没装或版本太低；CentOS 装libzip-devel，Ubuntu 装libzip-dev - 查 redis 失败？运行
ls /usr/include/hiredis.h，不存在就装hiredis-devel（CentOS）或libhiredis-dev（Ubuntu） - 注意：有些新版本 libzip（如 1.9+）需要手动
ldconfig刷新库缓存，否则 PHP 编译时仍找不到 - 别用
yum install php-pecl-zip这类系统包——路径、ZTS、API 全都不匹配，装了也白装
排查软件源是否被墙或配置错误
宝塔在后台下载扩展源码、依赖包时走的是系统默认源。国内服务器如果没换清华、阿里云等镜像源，经常卡在 Connection timed out 或 Failed to download。
- 执行
curl -I https://pecl.php.net，如果超时或返回 403，基本确定源不通 - CentOS：改
/etc/yum.repos.d/CentOS-Base.repo为清华源；同时确保epel源已启用（yum install epel-release） - Ubuntu：改
/etc/apt/sources.list为阿里云或清华源，然后apt update - 宝塔自己也会从
download.bt.cn拉脚本（比如 fileinfo），如果这个域名解析失败，可临时加 hosts：124.238.206.152 download.bt.cn
真正卡住的地方往往不是“怎么装”，而是“为什么连 configure 都跑不起来”——先盯住 gcc 和 libzip-devel 这两个点，90% 的 zip、redis、fileinfo 安装失败都能当场定位。
