PHP 7.4老项目接口报错需逆向追踪：先确认Nginx是否将.php请求正确转发给PHP 7.4（检查配置中include enable-php-74.conf及fastcgi_pass与php-fpm listen地址严格一致），再验证php-fpm进程真实运行（ps aux | grep php-fpm-74）、扩展完整启用（mbstring/curl/pdo_mysql等），最后开启display_errors=On并用phpinfo()和error_log定位具体报错行。
PHP 7.4 老项目接口报错时，不能只盯着代码看，必须从请求入口开始逆向追踪：确认 nginx 是否把 .php 请求真正交给了 PHP 7.4 的 php-fpm 进程、检查 php-fpm 是否真在运行且配置无冲突、验证扩展是否加载完整、再打开错误提示定位到具体哪一行代码崩了——漏掉任一环，都会让 var_dump() 白白输出在空白页里。
确认 nginx 是否把请求正确转发给 PHP 7.4
进宝塔 → 网站 → 对应站点 → 配置文件，找到 location ~ \.php$ { 这一段。
检查里面是否有 include enable-php-74.conf; 这行。如果写的是 enable-php-80.conf 或压根没这行，Nginx 根本不会把 .php 文件交给 PHP-FPM 处理，直接返回 404 或空白页。
若用的是 include 方式，点开 /www/server/nginx/conf/enable-php-74.conf 文件，核对 fastcgi_pass 的值是否与 PHP 7.4 的 listen 地址完全一致——比如 php-fpm.d/www.conf 里写的是 listen = /tmp/php-cgi-74.sock，那这里就必须是 fastcgi_pass unix:/tmp/php-cgi-74.sock；若写成 127.0.0.1:9000 就会 502。
立即学习“PHP免费学习笔记（深入）”；
改完配置后，必须先点「保存」→ 再点「重载配置」。只点「重启 Nginx」不生效，因为旧配置仍在内存中运行。
验证 PHP-FPM 进程是否真实存活
宝塔面板上显示“PHP-7.4 正在运行”，不代表进程活着。执行：ps aux | grep php-fpm-74。
如果输出里只有 grep 进程本身，没有 php-fpm: master process 字样，说明 php-fpm 没启动成功。
进一步查原因：运行 systemctl status php-fpm-74，重点看 Active: 后面是 active (running) 还是 failed。若为 failed，立刻执行 php-fpm -t -c /www/server/php/74/etc/php-fpm.conf 测试配置语法——语法错误会导致 master 进程启动即退出。
注意：CentOS 7 系统下若报 libsodium.so.23 找不到，需先 yum install epel-release → yum --enablerepo=epel install libsodium -y → 重启 PHP 服务。
开启错误报告并定位真实报错点
在接口入口文件（如 api.php 或 index.php）最顶部插入三行：
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
这一步必须做，否则 create_function() 已废弃、undefined function、mb_strpos 第三个参数类型错误等致命问题，只会表现为白屏或空响应，日志里也不留痕迹。
如果仍看不到错误，检查 php.ini 中 log_errors 是否为 On，并确认 error_log 指向的路径有写入权限，例如 /www/wwwlogs/php-error.log。
常见报错直指兼容性问题：
• Fatal error: Uncaught Error: Call to undefined function create_function() → 替换为 fn($x) => $x * 2 或 function($x) { return $x * 2; }；
• Warning: mb_strpos(): Offset must be contained in string → 检查第三个参数是否为 float，强制转 int：(int) $offset；
• Warning: json_encode(): type is not supported → 检查传入的数据是否含 NaN、INF 或非法 UTF-8 字节。
检查必需扩展是否已启用
方法一：访问 phpinfo.php 页面，搜索 mbstring、curl、json、pdo_mysql、zip、opcache，确认状态均为 enabled。
方法二：进宝塔「软件商店」→ 找到「PHP 7.4管理」→ 「设置」→ 「安装扩展」，勾选并安装以下七项：mbstring、curl、gd、xml、zip、pdo_mysql、opcache。
zip 扩展缺失会导致 Composer 安装失败或解压异常；mbstring 缺失会让中文字符串截断、strpos 中文失效；opcache 不启用会使接口响应慢 3 倍以上。
全部勾选安装完毕后，必须点击「重启 PHP 服务」——扩展不会热加载，不重启就等于没装。
快速验证接口是否收到原始请求数据
在接口开头加入调试段：
$raw = file_get_contents('php://input');
error_log("RAW: " . print_r($raw, true), 3, '/tmp/api-debug.log');
var_dump($_GET, $_POST, json_decode($raw, true)); exit;
这能立刻区分问题是出在 Nginx 转发层（$_GET/$_POST 全为空）、Content-Type 解析层（$raw 有内容但 json_decode 失败），还是后续业务逻辑层。
特别注意：application/json 请求体无法通过 $_POST 获取，必须读取 php://input；若前端发的是 multipart/form-data，则 $_POST 和 $_FILES 才有效，$raw 为空。
