Laravel关联查询报Unknown column 'badges.badge_user_id'如何解决

错误原因 #

你遇到的报错是因为关联类型定义错误：用户（User）和徽章（Badge）是典型的多对多关联，中间表badge_user仅存储两边的关联关系。你在中间表模型BadgeUser中错误使用hasMany关联Badge，Laravel会默认在badges表查找不存在的badge_user_id外键，触发字段不存在的报错。

修复步骤 #

1. 修正模型关联 #

这里提供两种常用实现方案，按需选择即可：

方案A：使用Laravel默认多对多关联（无需额外中间表模型，更简洁）

在User模型中添加和徽章的关联：

// App\Models\User.php
public function badges()
{
    return $this->belongsToMany(Badge::class)
        ->withTimestamps()
        ->wherePivotNull('deleted_at'); // 过滤中间表已软删除的关联记录
}

在Badge模型中添加和用户的关联：

// App\Models\Badge.php
public function users()
{
    return $this->belongsToMany(User::class)
        ->withTimestamps()
        ->wherePivotNull('deleted_at');
}

方案B：保留BadgeUser中间表模型（适合需要处理中间表额外逻辑的场景）

修正BadgeUser模型关联：

// App\Models\BadgeUser.php
public function badge()
{
    // 中间表单条记录对应唯一徽章，使用belongsTo关联
    return $this->belongsTo(Badge::class, 'badge_id');
}

public function user()
{
    // 中间表单条记录对应用户
    return $this->belongsTo(User::class, 'user_id');
}

修正Badge模型关联：

// App\Models\Badge.php
public function badgeUsers()
{
    // 单个徽章对应多条中间表记录，使用hasMany关联
    return $this->hasMany(BadgeUser::class, 'badge_id');
}

2. 修正业务查询&资源代码 #

方案A使用示例

直接查询用户关联的徽章即可，不需要操作中间表：

// 控制器查询代码，预加载关联避免N+1问题
$user = User::with('badges')->find($userId);
// 资源返回
return BadgeResource::collection($user->badges);

方案B使用示例

如果从中间表查询数据，资源层调整如下：

// BadgeUserResource的toArray方法
public function toArray($request)
{
    return [
        'user_id' => $this->user_id,
        'awarded_at' => $this->created_at,
        'badge' => new BadgeResource($this->badge),
    ];
}

// 控制器查询代码
$badgeUsers = BadgeUser::with('badge')->where('user_id', $userId)->get();
return BadgeUserResource::collection($badgeUsers);

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