php 8.1 严格校验字符串参数类型，null/false 传入 explode 等函数会报错；需在模板、控制器、配置处用 (string)($var ?? '') 或 preg_split 替代，并检查第三方包兼容性。
ThinkPHP 6 项目切到 PHP 8.1 后字符串参数报错，核心原因是 PHP 8.1 加强了函数参数类型校验，不再容忍 null、false 或未初始化变量直接传给期待 string 的函数（比如 explode()、str_replace()、mb_strlen() 等）。常见错误提示是：Uncaught ValueError: explode(): Argument #2 ($string) must be of type string, null given。
重点查这三类地方
不是所有字符串操作都出问题，优先盯紧这些高频“雷区”：
-
模板中直接调用函数：如
{:explode(',', $tags)}，当$tags是null或false时崩； -
控制器里处理用户输入：如
explode('/', input('path'))，input()返回null时直接传入； -
配置解析或日志拼接：如
explode(" ", $config['desc'] ?? '')漏了判空，$config['desc']本身为null就触发报错。
修复方法要简单可靠
不建议全局覆盖函数或加大量 @ 抑制，推荐以下两种落地方式：
-
显式转字符串 + 空值兜底：把
explode(',', $tags)改成explode(',', (string)($tags ?? ''))； -
统一用
preg_split()替代：它对空字符串更友好，且能保留空元素，例如preg_split('/,/', (string)($tags ?? ''), -1, PREG_SPLIT_NO_EMPTY)； -
关键位置加类型判断：在调用前加
is_string($val) || is_numeric($val)，避免传入布尔或数组。
别漏掉扩展包里的隐患
ThinkPHP 自身在 TP6.0.14+ 已修复大部分内部调用，但你用的第三方包（如 topthink/think-captcha、topthink/think-queue）可能仍存在类似写法。检查报错堆栈，若指向 vendor/ 下的文件：
- 先确认该包是否已发布适配 PHP 8.1 的版本（看其
composer.json中"php": "^7.4 || ^8.0"）； - 若无更新，可临时在对应代码行手动加
(string)强转，比如imagestring($im, 5, mt_rand(0, (int)$w), mt_rand(0, (int)$h), (string)$char, $color)； - 长期方案是提 issue 或 fork 后提交 PR，推动维护者适配。
不复杂但容易忽略
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
