Laravel关联查询报错：SQLSTATE[42S22] 列teams.team_b_id不存在

问题根源 #

你在Competition模型中定义的team关联方法参数错误：
belongsTo的正确参数顺序是：

• 关联模型类
• 当前表的外键字段（比如team_a_id）
• 关联表的主键字段（默认是id，可省略）

你写的belongsTo(Team::class, 'team_a_id', 'team_b_id')会让Laravel误以为要关联teams表的team_b_id字段，但这个字段根本不存在，直接导致报错。另外，你需要同时关联team_a_id和team_b_id两个外键到teams表，所以不能只定义一个关联方法。

修复方案 #

1. 修正模型关联 #

在Competition.php中为两个队伍分别定义关联：

public function teamA()
{
    return $this->belongsTo(Team::class, 'team_a_id');
}

public function teamB()
{
    return $this->belongsTo(Team::class, 'team_b_id');
}

2. 调整控制器查询逻辑 #

要实现搜索任意一个队伍名称的功能，需要结合whereHas和orWhereHas：

public function index()
{
    $keyword = request('search') ?? null;
    $query = Competition::query();

    if ($keyword) {
        $query->where(function ($q) use ($keyword) {
            $q->whereHas('teamA', function ($subQ) use ($keyword) {
                $subQ->where('title', 'LIKE', "%{$keyword}%");
            })->orWhereHas('teamB', function ($subQ) use ($keyword) {
                $subQ->where('title', 'LIKE', "%{$keyword}%");
            });
        });
    }

    $competitions = $query->paginate(25);
    return view('Admin.competitions.index', compact('competitions'));
}

额外提示 #

• 若只需搜索某一个队伍，直接使用对应的whereHas('teamA')或whereHas('teamB')即可
• 为避免SQL注入，建议使用参数绑定的写法（Laravel会自动处理，但显式绑定更安全）：

  $subQ->where('title', 'LIKE', DB::raw('concat("%", ?, "%")'), [$keyword]);
  

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