Laravel API资源嵌套hasMany关联分页缺失meta和links问题咨询

当你将分页器传递给PostResource::collection()并直接嵌套在UserResource的返回数组中时，Laravel仅会提取分页器内的数据集合完成资源转换，分页器自带的导航链接（links）、分页元信息（meta）会被自动丢弃——只有当资源集合作为响应的顶级返回值时，框架才会自动附加这些分页相关信息。

1. 修改UserResource代码 #

手动拆分分页器的内容，将数据、导航链接、元信息都显式返回：

public function toArray($request)
{
    // 先获取posts关联的分页器实例
    $postsPaginator = $this->posts()->paginate(10);
    
    return [
        'id' => $this->id,
        'name' => $this->name,
        'email' => $this->email,
        'posts' => [
            // 转换数据集合
            'data' => PostResource::collection($postsPaginator),
            // 提取分页导航链接
            'links' => $postsPaginator->linkCollection()->toArray(),
            // 提取分页元信息（总条数、当前页、每页条数等）
            'meta' => $postsPaginator->toArray()['meta'] ?? []
        ],
    ];
}

2. 优化控制器代码 #

你原有控制器中with('posts')预加载是冗余的：资源中调用$this->posts()->paginate()会重新执行关联查询，预加载的posts数据完全不会被用到，反而会造成多余的查询，直接去掉即可：

$user = User::query()
    ->where('id', $userId)
    ->firstOrFail();

return new UserResource($user);

可选优化：避免分页页码冲突 #

如果接口同时存在多层分页，可自定义posts分页的页码参数名，避免和其他分页的page参数冲突：

// 第二个参数为查询字段，第三个为页码参数名，请求时用posts_page参数控制posts分页的页码
$postsPaginator = $this->posts()->paginate(10, ['*'], 'posts_page');

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