PHP 7.1 升级到 8.4 报错本质是跨多个大版本导致的兼容性断层，需先开启错误显示或查 php_error.log 定位真实错误，再重点修复 each()、create_function()、mysql_*()、assert(字符串)、__toString() 返回类型等硬性冲突，并同步升级扩展与框架。
PHP 7.1 升级到 8.4 后报错，本质是跨了 三个大版本（7.1 → 7.2 → 7.3 → 7.4 → 8.0 → 8.1 → 8.2 → 8.3 → 8.4），兼容性断层极大。直接跳升会触发大量废弃语法、移除函数、类型强制校验和扩展行为变更，导致 500 错误、空白页或 Fatal Error。解决不能靠“试错”，而要分步定位、逐层修复。
PHP 8.4 报错必须先看到真实错误信息
PHP 8.4 默认关闭 display_errors，且解析失败时直接返回 500，不输出任何提示。
- 在网站根目录
index.php第一行<?php后立即加：error_reporting(E_ALL); ini_set('display_errors', '1'); - 若仍无输出，说明错误发生在 PHP 解析阶段之前（如语法错误、扩展加载失败），需查日志：
- 宝塔中进入【软件商店】→ PHP 8.4 → 【设置】→ 【配置修改】→ 找
error_log路径（通常是/www/server/php/84/logs/php_error.log） - SSH 执行：
tail -n 50 /www/server/php/84/logs/php_error.log - 重点看含
Fatal error、Parse error、Cannot declare class、Class not found的行
- 宝塔中进入【软件商店】→ PHP 8.4 → 【设置】→ 【配置修改】→ 找
重点排查 PHP 7.1 遗留代码中的硬性冲突项
这些在 PHP 7.1 中可能只是警告或能运行，但在 PHP 8.4 中直接致命：
-
each()、reset()、next()等数组指针函数：已彻底移除
✅ 替换为foreach或array_keys()+ 下标访问 -
create_function()：PHP 7.2 起废弃，8.0 起删除
✅ 全部改为匿名函数：$fn = function($x) { return $x * 2; }; -
mysql_*()系列函数：早在 PHP 7.0 就被移除，若你项目还在用，说明长期未维护
✅ 必须迁移到mysqli_*或 PDO，并检查所有 SQL 拼接逻辑（防注入） -
assert()传字符串：PHP 8.0 起禁止动态执行，会抛ParseError
✅ 改为布尔表达式：assert($a === $b);，禁用字符串模式 -
__toString()方法：PHP 8.0 起强制要求返回string，不能 echo 或 void
✅ 检查所有类的__toString()，末尾必须有return (string)$val;
session 相关报错高频且隐蔽
PHP 8.4 对会话启动更严格，常见报错：
立即学习“PHP免费学习笔记（深入）”；
-
Failed to initialize storage module→session.save_path目录不存在或www用户无写权限
✅ 创建目录并赋权：mkdir -p /www/wwwroot/your.site/runtime/session && chown -R www:www /www/wwwroot/your.site/runtime -
Failed to decode session object→ PHP 7.1 时期生成的旧 session 文件无法被 8.4 反序列化
✅ 清空旧会话：rm -f /var/lib/php/sessions/*（Linux）或对应session.save_path下所有文件 -
session_start() returns false→ 错误被静默吞掉
✅ 加强判断：if (session_status() === PHP_SESSION_NONE) { if (!session_start()) { $err = error_get_last(); error_log('Session start failed: ' . ($err['message'] ?? 'unknown')); } }
扩展与依赖必须同步升级
PHP 7.1 项目大概率依赖老旧扩展或框架，它们在 PHP 8.4 下多数不兼容：
- Redis 扩展需 ≥ 5.3.0（7.1 常用 3.x 或 4.x）
- GD 扩展需 ≥ 2.3.0
- Composer 依赖需全面检测：在项目根目录运行
composer check-platform-reqs composer update --with-all-dependencies
- ThinkPHP ≤ 5.1、Laravel ≤ 7.x、Yii ≤ 2.0.45 等均不支持 PHP 8.4，必须升级主框架版本
不复杂但容易忽略
