核心问题是环境不一致：线上PHP 7.4未真实生效、Nginx与PHP-FPM配置不匹配、扩展缺失、权限错误或配置项差异（如short_open_tag、date.timezone），需逐项验证版本、进程、socket、扩展、权限及错误日志。
PHP 7.4 本地运行正常、线上却报错，核心问题几乎都出在“环境不一致”上——不是代码错了，而是线上少东西、配错了、权限不对，或者版本表面是7.4、实际没生效。排查要从服务链路和配置细节入手，而不是反复改代码。
确认线上 PHP 7.4 真实生效
宝塔面板显示“PHP版本：7.4”不等于它真在跑。必须验证三点：
- 执行 php -v 看命令行版本是否为 7.4.x；
- 建一个 phpinfo.php（内容
<?php phpinfo(); ?>），访问该文件，确认页面顶部写的是 PHP Version 7.4.x，且 Loaded Configuration File 指向/www/server/php/74/etc/php.ini； - 执行 ps aux | grep php-fpm-74，看到
php-fpm: master process才算进程真在运行；若只有 grep 行，说明 PHP-FPM 启动失败，需查 systemctl status php-fpm-74 和 php-fpm -t -c /www/server/php/74/etc/php-fpm.conf。
检查 Nginx 转发与 PHP-FPM 监听是否匹配
502 错误的头号原因就是 nginx 想把请求发给 PHP，但找不到正确的“门”。关键看两处是否完全一致：
- 打开 /www/server/php/74/etc/php-fpm.d/www.conf，找到
listen =这一行，记下它的值（常见为unix:/tmp/php-cgi-74.sock或127.0.0.1:9000）； - 进宝塔 → 网站 → 对应站点 → 配置文件，找到
location ~ \.php$ {段，确认fastcgi_pass的值和上面listen完全相同（不能混用 socket 和 IP:端口）； - 确认配置里有
include enable-php-74.conf;这行，而不是 80 或其他版本；改完后务必点“保存”再点“重载配置”，只重启 Nginx 不生效。
核对扩展、权限与错误报告
白屏或 500 错误往往卡在这三步：
立即学习“PHP免费学习笔记（深入）”；
- 扩展缺失：进宝塔「软件商店」→「PHP 7.4 管理」→「安装扩展」，确保已启用 mbstring、curl、gd、xml、zip、pdo_mysql、opcache；装完必须重启 PHP 服务；
-
目录权限错误：执行
ls -ld /www/wwwroot/你的域名，第3、4列必须是www www；如果不是，运行chown -R www:www /www/wwwroot/你的域名；再检查index.php权限是否为 644（chmod 644 index.php）； -
错误被静默吞掉：在 php.ini 中设
display_errors = On、error_reporting = E_ALL、log_errors = On，重启 PHP 后刷新页面，看是否出现具体报错；若仍空白，立即查/www/wwwlogs/你的域名.error.log和/www/server/php/74/var/log/www-error.log。
比对本地与线上差异项
本地能跑，说明代码本身无硬性语法错误；线上挂掉，大概率是以下几项不一致：
- PHP 版本细节：本地可能是 7.4.33，线上是 7.4.16，某些安全补丁会影响函数行为；
-
扩展版本或开关状态：比如本地开了
fileinfo，线上没开，调用finfo_open()就报Call to undefined function； -
配置项差异：如
short_open_tag = Off（线上默认关）、date.timezone未设置（导致date()报 Warning）、memory_limit过小； - 数据库或外部服务连接：线上数据库密码不同、host 写成 localhost（而 PHP-FPM 在容器或 socket 模式下无法解析）；
-
文件路径大小写或符号：Linux 区分大小写，
require 'Config.php'在 Windows 下能过，Linux 下直接 fatal error。
