PHP 8.1 中 count() 不接受 null，需将裸 count($var) 替换为 is_array($var) && count($var) > 0 或 empty($var)，并检查模型关联、配置读取及第三方包兼容性。
count() 报错 Argument #1 ($value) must be of type Countable|array, null given，是 PHP 8.1 严格类型校验的典型表现——它不再容忍向 count() 传入 null，而 ThinkPHP 6.0 旧项目中不少地方（尤其模型关联、配置读取、第三方插件）仍存在这类松散写法。
核心原因不在框架主干（TP6.0.10+ 已适配），而在你项目里的实际调用链：某个变量本该是数组，却因初始化缺失、条件未覆盖或数据未返回，最终成了 null，PHP 8.1 直接中断执行。
? 快速定位出问题的代码位置
报错堆栈通常指向类似这样的行：
count($data) // 或 count($relation->getData())
常见触发点有三类：
立即学习“PHP免费学习笔记（深入）”；
- 模型关联未定义或查询失败，
$user->posts返回null而非空集合 - 配置文件（如
config/database.php）某项返回null，后续被直接传给count() - 第三方扩展（如
think-captcha、think-queue）调用了get_class_vars()获取不存在的静态属性，返回null
运行以下命令确认环境：
php -v # 确保是 8.1.x php think version # 确保 ≥ 6.0.10（低于则先升级框架）
✅ 修复方案（按优先级排序）
1. 加判空防护（最快见效，推荐先做）
把所有裸 count($var) 替换为安全写法：
// ❌ 危险
if (count($items) > 0) { ... }
// ✅ 安全
if (is_array($items) && count($items) > 0) { ... }
// 或更简洁
if (!empty($items)) { ... } // empty() 对 null/array/[] 都安全⚠️ 注意：
empty()在 TP6 中对对象可能不适用，若$items是模型实例，优先用is_array($items) || $items instanceof \think\Collection
2. 检查模型关联与数据获取逻辑
// 错误示范：没判空就直接 count
$posts = $user->posts;
echo count($posts); // $posts 可能为 null
// 正确写法
$posts = $user->posts;
if ($posts && method_exists($posts, 'count')) {
echo $posts->count();
} else {
echo 0;
}
// 或统一转为 Collection（TP6 推荐）
$posts = $user->posts ?: collect([]);
echo $posts->count();3. 升级或替换不兼容的第三方包
检查 composer.json 中这些常见“雷区”包是否支持 PHP 8.1：
| 包名 | 最低兼容版 | 检查命令 |
|---|---|---|
topthink/think-captcha |
≥ v3.0.10 | composer show topthink/think-captcha |
topthink/think-queue |
≥ v3.0.9 | composer why-not topthink/think-queue ^3.0 |
topthink/think-helper |
≥ v3.1.5 | 若仍在用 v2.x，必须升级 |
执行：
composer update topthink/think-captcha topthink/think-queue --with-dependencies
若某包已停止维护（如老版微信 SDK），需替换为社区维护分支或改用手动 HTTP 请求。
? 别踩这些坑
- 不要试图在
php.ini里关掉严格模式（PHP 8 的类型强制无法关闭） - 不要给
count()加@抑制错误——这只会掩盖问题，且 PHP 8.0+ 中部分错误无法被抑制 - 不要全局搜索替换
count(→count((array)—— 强转可能破坏业务逻辑（比如把对象转成空数组）
修复本质不是“让 count 能接 null”，而是让业务逻辑显式处理边界情况。PHP 8 把长期被忽略的隐患暴露出来，趁这次升级，把 null 流程补全，代码反而更健壮。
