PHP 8.2 新项目上线报错应先分层定位：一查 phpinfo() 确认 PHP 是否真正运行；二开 display_errors=E_ALL 并盯紧 php_error.log；三验 PHP 8.2 特有兼容项（动态属性、str_contains 等）；四查目录权限与缓存残留。
PHP 8.2 新项目上线报错，核心不是“修代码”，而是快速判断错误发生在哪一层：是环境没搭好、配置没生效、扩展没加载，还是代码真不兼容。别急着改业务逻辑，先稳住执行链路。
第一步：确认 PHP 是否真正运行起来
很多“500”或空白页，其实 PHP 根本没被调用。先做最基础的验证：
- 在网站根目录放一个 info.php，内容仅一行：
<?php phpinfo(); ?> - 浏览器访问
http://你的域名/info.php—— 如果也报 500 或 404，问题不在你项目代码，而在 Web 服务器（Nginx/Apache）或 PHP-FPM 层 - 终端执行
ps aux | grep php-fpm看进程是否存在；再用curl -I http://localhost检查服务响应头是否正常 - phpEnv 或 FlyEnv 用户，务必进界面点 Config 查看 Loaded Configuration File 路径，确认你改的是那个生效的 php.ini
第二步：打开错误报告并盯紧日志
PHP 8.2 默认更“沉默”，不主动报错是常态。必须手动撬开它的嘴：
- 修改 php.ini：
display_errors = On、error_reporting = E_ALL、log_errors = On、error_log = /path/to/php_error.log - 特别注意 Xdebug：如果启用了 Xdebug 3.x，
xdebug.force_display_errors = 1会绕过 display_errors 设置，必须显式设为0 - PHP-FPM pool 配置（如
www.conf）中若有php_admin_flag[display_errors] = on，它会强制覆盖所有其他设置，必须改成off - 刷新页面后，第一时间打开
php_error.log——90% 的致命错误（Parse error、class not found、require 失败）都藏在这里
第三步：重点排查 PHP 8.2 特有兼容性问题
新项目用 PHP 8.2，常见报错往往不是语法写错，而是踩了新版本的“规则线”：
立即学习“PHP免费学习笔记（深入）”；
-
动态属性警告：如
Creation of dynamic property xxx is deprecated，多见于 ThinkPHP 5.1 等老框架。升级到 v5.1.42+ 或在类顶部加#[\AllowDynamicProperties] -
函数/语法不可用：比如写了
str_contains()却没确认最低版本（PHP 8.0+），或match表达式漏了 default 分支，解析阶段直接报 Fatal -
上传下载卡死 500：检查
upload_tmp_dir目录是否存在、可写、未被open_basedir拦截；下载前确保没任何输出（空格、BOM、echo）破坏header() -
扩展缺失或禁用：PDO、mbstring、json、ctype 是多数框架刚需。用
php -m或phpinfo()页面确认已启用；phpstudy 用户需手动补全extension_dir路径
第四步：验证关键路径与权限
尤其对 Laravel、ThinkPHP 等框架，上线后常因目录权限或缓存残留失败：
- 检查
storage/和bootstrap/cache/是否存在且可写（Linux/macOS 执行chmod -R 755 storage bootstrap/cache） - Laravel 项目上线前务必清空缓存：
php artisan config:clear && php artisan cache:clear && php artisan view:clear - ThinkPHP 5.1 升级后必须删掉
runtime/目录，否则旧缓存类定义仍被加载 - 检查
.env文件中APP_DEBUG=false、LOG_LEVEL=error等设置是否合理，避免调试信息泄露
