宝塔面板PHP 7.4网站部署失败的根本原因是扩展缺失、依赖未就绪或配置未生效，需依次确认PHP版本选中并重启服务、验证phpinfo显示7.4.x及正确php.ini路径、补全mbstring/curl/gd/xml/zip/pdo_mysql/opcache等必需扩展、修复libsodium或zip路径等底层依赖，并通过错误日志和display_errors定位真实报错点。
宝塔面板中PHP 7.4环境下网站部署失败，常见表现为首页白屏、500错误、Fatal error或“Call to undefined function”类报错，根本原因往往是扩展缺失、依赖库未就绪或配置未生效，而非PHP本身安装失败。
确认PHP 7.4是否真正在运行
第一步：进宝塔「网站」→ 找到对应站点 → 点击「设置」→ 查看「PHP版本」下拉框当前选中项是否确为PHP 7.4。若显示“未安装”或灰显，请先去「软件商店」安装PHP 7.4。
第二步：安装完成后，必须点击「设置」→「服务」→「重启PHP服务」，否则新版本不会加载到FPM进程里——这一步跳过，所有后续操作都无效。
第三步：新建一个phpinfo.php文件（内容为<?php phpinfo(); ?>），上传至网站根目录，浏览器访问your-site.com/phpinfo.php，页面顶部明确显示“PHP Version 7.4.x”，且“Loaded Configuration File”路径指向/www/server/php/74/etc/php.ini，才算真正启用。
立即学习“PHP免费学习笔记（深入）”；
补全PHP 7.4必需扩展
宝塔安装PHP 7.4后，默认只启用最基础扩展，而WordPress、ThinkPHP、Dedecms等主流CMS至少需要以下模块才能启动：
进入「软件商店」→ 找到「PHP 7.4管理」→ 点击「设置」→ 切换到「安装扩展」选项卡。
勾选并安装：【mbstring、curl、gd、xml、zip、pdo_mysql、opcache】。其中opcache不装会导致性能骤降，zip缺失会使Composer无法解压依赖包，mbstring缺失则中文字符串处理直接报错。
全部安装完毕后，务必再次点击「重启PHP服务」——扩展只有在服务重启后才会被php-fpm子进程加载。
修复常见底层依赖缺失
方法一：CentOS 7系统下libsodium缺失导致PHP 7.4启动失败
执行php-fpm -t报错“error while loading shared libraries: libsodium.so.23: cannot open shared object file”，说明系统级依赖未就位。
先确认系统版本：cat /etc/centos-release，若为CentOS 7.x，则需手动安装EPEL源与libsodium：
yum install epel-release -y → yum --enablerepo=epel install libsodium libsodium-devel -y → 重启PHP服务。
注意：CentOS 7官方源已停更，若yum报404错误，必须先更换为阿里云镜像源，否则无法安装任何依赖。
方法二：Ubuntu系统下zip扩展路径找不到
宝塔在Ubuntu上编译PHP 7.4时偶发zip扩展路径识别异常，表现为安装后仍提示“zip extension not loaded”。此时不要反复重装，直接执行：
ln -sf /usr/lib/php/20190902/zip.so /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/zip.so
再编辑/www/server/php/74/etc/php.ini，在extension_dir下方添加一行：extension=zip.so，保存后重启PHP服务。
验证并定位真实报错点
第一步：打开宝塔「网站」→ 对应站点 → 「错误日志」，直接查看最新一条Fatal error或Parse error的完整堆栈，记下出错文件路径和行号。
第二步：该文件若属于你自定义代码，重点检查是否调用了PHP 7.4已废弃但未彻底移除的函数，如mysql_connect()（应改用mysqli或PDO）、each()、create_function()；若属于WordPress等第三方程序，查其官网兼容性说明——WordPress 6.0+已完全支持PHP 7.4，但部分老旧插件仍不兼容。
第三步：临时开启PHP错误显示以快速定位：编辑/www/server/php/74/etc/php.ini，将display_errors = Off改为On，error_reporting = E_ALL，保存后重启PHP服务。生产环境调试完成后必须改回Off。
