PHP 7.1 升级到 8.3 后白屏或500错误，主因是废弃功能移除（如create_function、each、mcrypt_*）、扩展不兼容（ZTS/NTS混用致崩溃）、类型校验收紧（strict_types、json_decode返回值、字符串偏移）及错误默认静默；须先开错误日志或临时启用display_errors定位真实报错。
PHP 7.1 升级到 8.3 后出现白屏、500 错误、函数调用失败或类型报错，不是代码写错了，而是 PHP 运行时行为突变和废弃项被移除导致的——这些变化不会在 7.1 下暴露，却会在 8.3 启动瞬间崩断。
第一步：确认真实报错来源
别依赖浏览器 500 页面或空白响应。打开 PHP 错误日志路径（通常为 php.ini 中 error_log 指定位置），或临时在入口文件 public/index.php 顶部插入：
ini_set('display_errors', '1'); error_reporting(E_ALL);
这一步必须做，否则你看到的只是“页面打不开”，而看不到 【ParseError: syntax error, unexpected '?'】 这类致命线索——它直接指向空合并运算符（??）与联合类型兼容性问题。
立即学习“PHP免费学习笔记（深入）”；
第二步：检查废弃函数与语法硬淘汰项
PHP 8.0 起已彻底移除以下 7.1 中仍可用但早已标记 deprecated 的功能，任何残留调用都会触发 Fatal error：
方法一：全局搜索关键词
在项目根目录执行：grep -r "create_function\|each\|mysql_\|mcrypt_\|ereg_" . --include="*.php"
方法二：启用 PHP 7.4 过渡环境复现警告
先降级回 PHP 7.4，开启 error_reporting = E_DEPRECATED，运行一遍全链路（CLI + Web），把所有 Deprecated: 行全部记下——这些就是 8.3 的死刑名单。
特别注意：【mcrypt_* 系列函数在 7.2 已废弃、8.0 彻底删除，且 openssl_encrypt/decrypt 默认填充方式与 mcrypt 不同，解密旧数据会返回 false 或乱码】，这不是配置问题，是算法层断裂。
第三步：验证扩展兼容性与加载状态
PHP 8.3 不再支持 ZTS（线程安全）模式下的部分老扩展，尤其 Windows 下的 memcache.dll、sqlsrv.dll（旧版）、pdo_sqlsrv.dll（v4 以下）。
运行 php -m 查看已启用模块列表，对比 PHP 7.1 时期的 phpinfo() 截图；
若发现扩展名存在但功能异常（如 memcache_get() 返回 null 而非值），立即检查 DLL 文件名是否含 ts（ZTS）或 nts（非线程安全）后缀——PHP 8.3 官方构建默认为 NTS，【混用 ts/nts 扩展会导致 PHP 进程静默崩溃，错误日志里只有一行 segmentation fault】。
Windows 用户请直接去 Swoole Loader 全版本仓库下载对应 PHP 8.3-nts 的 php_memcache.dll，不要试图重命名旧版文件。
第四步：逐级收紧类型校验与运行时行为差异
PHP 8.3 对类型系统执行更严格推导，很多 7.1 下“侥幸通过”的代码会在此报错：
① 打开 php.ini，设置 zend.assertions = 1 并 assert.exception = 1，让断言失败抛异常而非静默忽略；
② 在 Composer 自动加载器前插入：declare(strict_types=1); 到所有核心业务文件顶部（非全局，按需加），观察哪些函数因参数类型松散被拦截；
③ 重点排查 json_decode() 返回值：PHP 7.1 默认返回 stdClass，PHP 8.3 在传入 true 第二参数时才返回数组，漏传会导致 foreach 报 Fatal error: Uncaught TypeError；
④ 检查字符串偏移访问：$str[0] 在 7.1 可读取首字符，在 8.3 中若 $str 为 null 或 false 会直接报 TypeError，必须先 is_string($str) 校验。
