Laravel项目报错：Property [name] does not exist on this collection instance求解决

问题场景 #

开发复古电子游戏售卖网站时，尝试显示单款游戏的多个流派，触发Property [name] does not exist on this collection instance错误；改用遍历关联集合后无报错，但页面未显示流派内容。

现有代码 #

触发错误的视图代码（index.blade.php） #

<div>
    @foreach ($games as $game)
        <div>
            <img src="{{ $game->cover }}" alt="{{ $game->title }}">
            <div>
                <h3>
                    <a href="/game/{{ $game->id }}">
                        {{ $game->title }}
                    </a>
                </h3>
                <p>
                    {{ $game->release_year}}
                    {{ number_format($game->price, 2, ',', '.') }}
                </p>
                <p>
                    {{ $game->genres->name}} // 此行触发错误
                </p>
            </div>
        </div>
    @endforeach
</div>

Game模型关联代码 #

public function genres(): BelongsToMany
{
    return $this->belongsToMany(Genre::class);
}

public function consoles(): BelongsToMany
{
    return $this->belongsToMany(Console::class);
}

Genre模型关联代码 #

public function games(): BelongsToMany
{
    return $this->belongsToMany(Game::class);
}

尝试的遍历代码 #

@foreach ($game->genres as $genre)
    {{ $genre->name }}
@endforeach

问题分析 #

1. 报错原因：$game->genres返回的是Eloquent集合（包含多个Genre模型实例），不是单个模型对象，直接访问->name属性会触发集合不存在该属性的错误。
2. 遍历无内容原因：未预加载关联数据导致延迟加载失效，或game_genre中间表（Laravel默认按字母顺序命名的多对多中间表）中无对应游戏与流派的关联记录。

解决方法 #

1. 预加载关联数据 #

在控制器查询游戏列表时，使用with('genres')预加载流派关联，避免N+1查询问题，确保关联数据被正确加载：

// 控制器示例代码
$games = Game::with('genres')->get();

2. 完善视图遍历逻辑 #

使用@forelse处理空状态，同时优化流派名称的显示格式：

<p>
    @forelse ($game->genres as $genre)
        {{ $genre->name }}@if(!$loop->last), @endif
    @empty
        暂无流派信息
    @endforelse
</p>

3. 验证中间表数据 #

检查数据库中的game_genre表，确认存在对应游戏ID和流派ID的关联记录，确保数据关联关系正确。

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