Laravel中封装分页对象到数组时元数据丢失问题

核心原因：Laravel分页对象的特殊序列化逻辑 #

你遇到的问题根源在于Laravel对分页对象的序列化处理机制：

• 当直接返回分页对象（比如LengthAwarePaginator或Paginator实例）时，Laravel的响应系统会自动识别这是分页类实例，触发专属序列化逻辑（通过JsonSerializable接口或toArray()方法），最终会完整输出data、links、meta全套分页数据。
• 但把分页对象放进普通数组返回时，PHP序列化数组只会提取对象的公共属性。而Laravel分页对象的links、meta等元数据并非直接存于公共属性，而是通过toArray()方法动态生成的，普通数组序列化不会触发这个方法，所以最终只保留了data部分。

解决办法 #

有两种简单可行的处理方式：

1. 先将分页对象转为数组再放入返回结构
   手动调用分页对象的toArray()方法，提前生成完整的分页数据结构，再放进返回数组：

public static function foo($data)
{
    if (gettype($data) === 'array')
        $data = (object)$data;

    $tt = [
        'foo' => $data->toArray()
    ];

    return $tt;
}

2. 用response()->json()手动处理响应
   借助Laravel的JSON响应处理器，让它自动识别分页对象并执行正确的序列化逻辑：

public static function foo($data)
{
    if (gettype($data) === 'array')
        $data = (object)$data;

    $tt = [
        'foo' => $data
    ];

    return response()->json($tt);
}

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