Laravel中如何为belongsToMany关联模型正确创建资源？

1. 修正关联调用名称 #

Post模型里的多对多关联需定义为复数形式（比如tags()），所以在PostResource中要调用$this->tags而非$this->tag——单数的tag对应一对一/一对多关联，多对多必须使用复数关联名，否则会找不到关联返回null。

2. 用资源集合处理多对多结果 #

belongsToMany关联返回的是标签集合，不是单个标签，因此要使用TagsResource::collection()包装结果，而非单个new TagsResource()：
修改PostResource的toArray方法：

public function toArray($request)
{
    return [
        'id' => $this->id,
        'title' => $this->title,
        'description' => $this->description,
        'tags' => TagsResource::collection($this->tags),
    ];
}

3. 预加载关联避免N+1问题 #

查询posts时必须预加载tags关联，否则会出现性能问题，甚至因懒加载失败导致返回null：

// 路由/控制器中的查询代码
$posts = Post::with('tags')->get();
return PostResource::collection($posts);

额外说明 #

如果需求确实是每个Post只返回单个标签（不符合多对多关联的设计初衷），可调整为：

// PostResource中修改
'tags' => new TagsResource($this->tags->first()),

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