PHP 7.4 迁移到 PHP 8.1 后类型报错，核心原因是 PHP 8.1 加强运行时类型校验，将原警告或静默转换升级为 TypeError/ValueError；需重点排查 explode、mb_strpos、array_merge 等函数传入 null/float/标量场景，用 (string)($var ?? '')、(int)$offset、is_array() 判空等精准修复，并检查第三方包兼容性。
PHP 7.4 迁移到 PHP 8.1 后出现类型报错，核心原因是 PHP 8.1 加强了运行时类型校验，把大量原本仅触发警告或静默转换的行为升级为 TypeError 或 ValueError。这不是配置问题，而是语言层面对类型安全的强制落地。处理关键不是“绕过”，而是识别错误模式、定位源头、做精准修复。
重点盯紧这三类高频类型报错
多数报错集中在以下函数和场景，优先排查：
-
字符串类函数：如
explode()、str_replace()、mb_strlen()、trim()等，传入null、false或未初始化变量时直接报Argument must be of type string, null given -
数值类函数：如
mb_strpos()第三个参数（$offset）若为浮点数（例如round(strlen($s)/2)返回 float），会触发TypeError: mb_strpos(): Argument #3 ($offset) must be of type int -
数组操作函数：如
array_merge()、count()接收null或标量时失败；foreach(null as $v)在严格模式下直接中止
修复策略：不加 @，不全局兜底，只做必要强转
避免用 @ 抑制错误或写通用包装函数，推荐就地、轻量、可读的修复方式：
- 对可能为空的变量，统一用
(string)($var ?? '')或(int)($var ?? 0)显式转换，例如：explode(',', (string)($tags ?? '')) - 对偏移量等整型参数，强制类型断言：
mb_strpos($str, 'x', (int)$offset) - 对数组类操作，先判空再执行：
if (is_array($list)) { foreach ($list as $v) { ... } }
检查第三方包与框架内部调用
ThinkPHP 6.0.14+、Laravel 9+ 等主流框架已适配 PHP 8.1，但你引入的扩展包（如 topthink/think-captcha、php-amqplib/php-amqplib）可能仍存在未判空或弱类型假设。方法：
立即学习“PHP免费学习笔记（深入）”；
- 看报错堆栈，确认是否指向
vendor/目录下的文件 - 查该包最新版
composer.json中"php":字段是否支持^8.0或^8.1 - 若无更新，临时在调用行手动加类型转换（如
(string)$char），并提 issue 推动维护者发布兼容版本
别忽略属性与构造函数的类型约束
PHP 7.4 引入的类型属性（如 public string $name;）在 PHP 8.1 下更严格：
- 赋值
null给非 nullable 属性（如public string $email;）会触发TypeError，必须改为public ?string $email; - 构造函数参数类型声明（如
function __construct(string $id)）不允许传null或数字字符串（除非启用弱类型转换），需提前校验或转换 - 继承父类时，子类构造函数参数类型不能比父类更宽松（协变规则），否则报错
