Laravel11+PHPStan下方法返回类型注释报错，如何解决？

这个错误的核心是PHPDoc中的命名空间解析规则导致的：

• 你的UserRepository类处于App\Repositories命名空间下，当你在返回类型注释中写App\Models\User时，Larastan会将其解析为相对命名空间，也就是App\Repositories\App\Models\User（相当于在当前命名空间基础上拼接路径），这显然不是你期望的模型类路径。
• 而你实际返回的LengthAwarePaginator<App\Models\User>是绝对命名空间下的正确类型，因此Larastan抛出类型不匹配的错误。

解决方法 #

有两种常用的修复方式：

方式1：导入命名空间后使用短类名

在UserRepository文件顶部导入所需的类：

use App\Models\User;
use Illuminate\Pagination\LengthAwarePaginator;

然后在PHPDoc中直接使用短类名：

/**
 * @return LengthAwarePaginator<User>
 */
public function index()
{
    return User::paginate();
}

方式2：使用绝对命名空间（加反斜杠前缀）

如果不想导入命名空间，在PHPDoc中给完整类名加上反斜杠前缀，明确指定这是根命名空间下的路径：

/**
 * @return \Illuminate\Pagination\LengthAwarePaginator<\App\Models\User>
 */
public function index()
{
    return \App\Models\User::paginate();
}

两种方式都能让Larastan正确识别类型，消除报错。

内容的提问来源于stack exchange，提问作者Dom