升级 PHP 8.1 后出现 TypeError 中断脚本，通常是因为代码中函数参数、返回值或类属性类型声明与实际传递值不匹配，PHP 8 废除了部分隐式类型转换。排查核心是开启错误显示定位具体代码行，修改类型声明或确保传入值符合类型要求，避免在生产环境直接关闭错误报告而掩盖问题。

命令速用版

在脚本顶部临时开启错误显示，或在 php.ini 中配置日志路径，便于快速捕获 TypeError 详情。

php -i | grep "error_log"
php -r "ini_set('display_errors', 1); ini_set('display_startup_errors', 1); error_reporting(E_ALL);"

若使用 Web 服务，修改 php.ini 配置后需重启服务：

sudo systemctl restart php8.1-fpm
sudo systemctl restart nginx

为什么会这样

PHP 8 增强了类型系统，类型不匹配时直接抛出 TypeError 而非警告或隐式转换。在 PHP 8.1 环境中，为类属性设置的值、传递给函数的参数类型、函数返回的值若与声明类型不匹配，都会触发 TypeError 导致脚本中断。这种机制旨在提供更明确的错误信息，但会导致未适配的旧代码运行失败。

分步处理

按以下步骤定位并修复 TypeError，确保每一步都有明确的验证动作。

1. 开启错误报告与日志
在入口文件（如 index.php）最顶部添加以下代码，强制显示所有错误级别：

error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
同时确认 php.ini 中 log_errors = On 且 error_log 指向可写路径，如/var/log/php/error.log。修改配置后必须重启 Web 服务使配置生效。

2. 定位报错代码行
查看错误日志或浏览器输出，找到 TypeError 提示的具体文件和行号。典型报错信息包含"must be of type int, string given"或"Return value must be of type array, null returned"。
3. 修正类型声明或传入值
若函数声明为 function add(int $a)，调用时传入字符串"1"，需将传入值转换为整数或修改函数声明为 function add($a)。若使用类属性类型声明，确保赋值时类型匹配。禁止在 shutdown 函数里连数据库或发 HTTP 请求处理致命错误，资源可能已释放。
4. 检查第三方依赖
若报错发生在 vendor 目录，检查 composer 依赖是否支持 PHP 8.1。扩展 ABI 不匹配也可能导致启动失败，但 TypeError 通常指代码逻辑层面的类型冲突。优先用包管理器重装扩展：sudo apt install php8.1-xdebug。
怎么验证是否生效
执行 php -l your_script.php 检查语法无错误后，运行脚本观察是否不再中断。查看错误日志文件，确认没有新的 TypeError 记录。若使用 Web 界面，页面应正常加载且无空白页。CLI 模式下直接运行 php script.php，错误会原样输出到终端，这是最干净的报错来源。

常见坑
修改 php.ini 后未重启服务导致配置未生效，误以为代码已修复。共享主机环境无法修改 php.ini，需在脚本中动态启用错误报告。禁止在 register_shutdown_function 中处理复杂逻辑，只能做轻量日志记录。post_max_size 或 upload_max_filesize 配置过小可能导致请求被截断，但这是另一种错误，需区分 TypeError 与配置错误。
常见问题
TypeError 和 Fatal error 有什么区别？
TypeError 是 Fatal error 的一种具体类型，专指类型不匹配导致的致命错误。PHP 8 中类型错误会直接抛出 TypeError 异常类，便于 catch 捕获，但未捕获时同样终止脚本。
能否临时关闭严格类型检查？
可以在文件顶部移除 declare(strict_types=1); 声明，允许隐式转换。但建议修复代码类型匹配而非关闭严格模式，以避免潜在逻辑错误。
升级后所有脚本都报 TypeError 怎么办？
说明代码库大量依赖隐式类型转换，需批量扫描代码库中的函数声明和调用处。优先修复核心业务逻辑，第三方库需升级到支持 PHP 8.1 的版本。
参考来源
PHP8 错误处理与异常机制的改进
如何修复 PHP8.1 启动失败_排查 PHP8.1 错误【修复】
PHP 代码运行错误怎么办_PHP 代码运行报错排查与解决【操作】
PHP 报错 Fatalerror 怎么办_常见致命错误排查方法【解答】
TypeError 官方文档说明