Laravel版本升级从来不是一件轻松的事，尤其是从5.x跨越到更高版本时，PHP版本往往也要跟着一起升级。升级完成后最让人头疼的，就是那些之前跑得好好的功能突然罢工。登录模块首当其冲：用户输入账号密码后页面直接500，或者虽然跳转成功但用户信息、角色权限全部加载不出来。这篇文章就聚焦两个最典型的问题：Countable致命错误和关系加载异常，把原因和解决方案一次讲清楚。
一、Countable错误是怎么来的
这个错误的完整提示通常是：count(): Parameter must be an array or an object that implements Countable。它的出现和PHP版本变化直接相关。PHP 7.2之前，对null或者标量类型调用count函数，只会返回1或0，程序不会中断。但PHP 7.2开始，这个行为变成致命错误，到了PHP 8更是直接抛出TypeError异常。
Laravel升级后碰到这个问题，往往是因为框架内部某些老代码或者项目里自定义的登录逻辑中，存在类似下面这样的写法：
// 旧写法，在PHP 7.2+会直接报错
$userCount = count($request->input('roles'));
if ($userCount > 0) {
// 为用户分配角色
}
当表单没有提交roles字段时，$request->input('roles')返回null，count(null)在新版本PHP下直接终止程序。修复方式很直接，在调用count之前先做类型判断：
// 方式一：先判断是否为数组
$roles = $request->input('roles', []);
$userCount = is_array($roles) ? count($roles) : 0;
// 方式二：利用null合并运算符配合类型转换
$roles = (array) $request->input('roles', []);
$userCount = count($roles);
除了显式调用count，还要警惕一些隐蔽场景。比如老项目中常用的strlen判断、对查询结果直接count等。Eloquent查询返回的Collection本身实现了Countable接口，对它count是安全的，但如果是first()返回的结果，类型可能是null或单个模型实例，这时候count就会出问题。建议全局搜索一遍count调用点，逐个排查参数来源。
二、登录成功后关系数据加载不出来
第二个问题更隐蔽。登录本身成功了，session也写入了，但进入后台首页后发现用户昵称、头像、所属角色全都显示为空，或者抛出Attempt to read property on null的错误。这通常是Eloquent关系定义或调用方式与新版本Laravel的行为不兼容导致的。
一个常见原因是模型中关系方法使用了过时的写法。比如老项目里的关系定义直接在方法里做了额外判断：
// 有问题的关系定义
public function roles()
{
if (auth()->check()) {
return $this->belongsToMany(Role::class);
}
return null; // 新版本中这会导致调用时报错
}
关系方法必须始终返回一个关系对象，绝不能返回null。新版本的Laravel在调用$user->roles时依赖关系对象来完成懒加载，拿到null就直接报错。正确的做法是保持关系定义纯粹：
// 正确的关系定义
public function roles()
{
return $this->belongsToMany(Role::class);
}
另一个高频原因是使用了withCount或动态属性访问时，配合了 $append机制，而新版本对模型序列化的处理更严格。如果访问器中抛出了异常，整个关系加载会静默失败，最后表现为数据为空。排查时可以在访问器内部临时加日志，确认是否被调用以及返回值是什么。
三、N+1查询消失与预加载失效的调整
升级后还有人发现，原来依赖的预加载突然不生效了，每个用户列表项都触发一次单独查询。这多半是预加载的写法与新版本不匹配。旧写法中，约束闭包内访问外部变量如果没有use关键字引入，在新版本严格模式下会直接报未定义变量：
// 写法有隐患
$users = User::with(['roles' => function ($query) {
$query->where('status', $status); // $status未通过use引入
}])->get();
// 正确写法
$users = User::with(['roles' => function ($query) use ($status) {
$query->where('status', $status);
}])->get();
另外要检查登录后的用户解析逻辑。如果项目里重写了Illuminate\Auth\Middleware\Authenticate或者在中间件里手动调用了load方法，升级后这些自定义代码可能与框架新的事件流冲突。建议尽量使用框架提供的Auth::user()->loadMissing('roles')来补充加载，它只在关系未加载时才执行查询，既安全又高效。
四、升级后的回归测试建议
问题修复不等于万事大吉。登录链路涉及认证、session、中间件、模型关系多个环节，强烈建议写一组特征测试覆盖关键路径：
public function test_user_can_login_and_load_roles()
{
$user = User::factory()->create();
$response = $this->post('/login', [
'email' => $user->email,
'password' => 'password',
]);
$response->assertRedirect('/home');
$this->assertAuthenticatedAs($user);
$this->assertNotNull($user->fresh()->roles);
}
同时建议在开发环境开启SQL日志，观察登录流程触发的查询是否符合预期。如果发现同一个关系被反复查询，说明懒加载策略需要调整为预加载。最后一点经验：升级前先在独立分支跑通全量功能测试，升级后重点回归登录、注册、权限校验这几个高危模块，能把线上事故的概率降到最低。
Laravel升级Countable错误登录失败修改时间：2026-09-10 22:36:40