Laravel多对多模型重写toArray()引发栈溢出问题及解决

嘿，这个问题我之前也踩过坑！你遇到的Maximum stack depth exceeded本质是循环引用引发的无限递归：当Department序列化时会加载关联的User，而User序列化又会反过来加载Department，一来一回停不下来，直接把调用栈撑爆了。

下面给你两种靠谱的解决方案，优先推荐第一种，这是Laravel官方推崇的最佳实践：

方案一：使用Laravel API资源（最推荐） #

API资源是Laravel专门为处理API输出设计的工具，既能完美解决循环引用问题，还能让输出格式的维护更灵活、解耦。

1. 创建资源类 #

先给Department和User分别生成资源文件：

php artisan make:resource DepartmentResource
php artisan make:resource UserResource

2. 编写DepartmentResource #

打开app/Http/Resources/DepartmentResource.php，定义你需要输出的字段：

<?php

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class DepartmentResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'caption' => $this->caption,
            'status' => $this->status,
            // 关键：whenLoaded只会在关联被预加载时才输出，避免不必要查询和循环
            'users' => UserResource::collection($this->whenLoaded('users')),
        ];
    }
}

3. 编写UserResource #

打开app/Http/Resources/UserResource.php，同样定义输出字段：

<?php

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class UserResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'username' => $this->username,
            'email' => $this->email,
            'status' => $this->status,
            'departments' => DepartmentResource::collection($this->whenLoaded('departments')),
        ];
    }
}

4. 在控制器中使用资源 #

比如Department控制器的列表接口：

public function index()
{
    // 预加载users关联，避免N+1查询
    $departments = Department::with('users')->get();
    return response()->json([
        'success' => true,
        'data' => DepartmentResource::collection($departments)
    ]);
}

User控制器的列表接口同理：

public function index()
{
    $users = User::with('departments')->get();
    return response()->json([
        'success' => true,
        'data' => UserResource::collection($users)
    ]);
}

这种方式的优势很明显：把API输出逻辑和模型解耦，后续改字段只需要动资源文件，whenLoaded还能避免不必要的关联查询，从根源上切断了循环引用。

方案二：修改toArray()方法，手动避免循环 #

如果不想用API资源，也可以直接修改模型的toArray()，手动控制关联输出的字段，不包含反向关联：

修改Department模型的toArray() #

public function toArray()
{
    $arr = parent::toArray();
    // 只返回User的必要字段，不包含departments关联
    $arr['users'] = $this->users->map(function($user) {
        return $user->only(['id', 'username', 'email', 'status']);
    });
    return $arr;
}

修改User模型的toArray() #

public function toArray()
{
    $arr = parent::toArray();
    // 只返回Department的必要字段，不包含users关联
    $arr['departments'] = $this->departments->map(function($dept) {
        return $dept->only(['id', 'caption', 'status']);
    });
    return $arr;
}

这种方式简单直接，但缺点是把API输出逻辑耦合到了模型里，后续维护起来不如API资源灵活。

为什么原来的代码会报错？ #

你原来的代码中，$arr['users'] = $this->users会触发User模型的toArray()，而User的toArray()又会调用Department的toArray()，形成无限递归，最终导致栈溢出。

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