SQL查询字段歧义问题：Laravel使用whereHas按ID筛选查询时报错

遇到的错误提示 #

涉及的表关联关系 #

错误原因 #

• 字段归属歧义：你用到的actor表和中间表film_actor都包含actor_id字段，查询时未指定字段所属表，SQL无法识别调用目标引发报错。
• 关联定义缺失：你当前的Film模型中没有声明和Actor模型的关联方法，whereHas依赖预定义的关联关系生成查询SQL，缺失定义也会导致查询逻辑异常。
• 额外属性错误：模型中声明的$sql属性为无效属性，Laravel批量赋值白名单属性应为$fillable，该错误会影响后续数据写入操作。

修复方案 #

1. 补全Film模型的关联定义与属性修正

class film extends Model{
    protected $table = "film";  
    protected $primaryKey = 'film_id';
    public $timestamps = false;
    use HasFactory;
    // 修正属性名，设置批量赋值白名单
    protected $fillable = ['film_id', 'title', 'length'];

    // 新增与Actor模型的多对多关联，指定中间表、关联外键
    public function actor()
    {
        return $this->belongsToMany(Actor::class, 'film_actor', 'film_id', 'actor_id');
    }
}

2. 修改查询语句，明确字段所属表

两种可选写法：

• 写法一：直接指定关联表字段

$film = film::whereHas('actor', function($q) use($actor_id){
    // 明确指定字段属于actor表，消除歧义
    $q->where('actor.actor_id', '=', $actor_id);
})->get();

• 写法二：针对中间表字段筛选（性能更优）
  如果筛选条件对应中间表字段，可直接用wherePivot方法：

$film = film::whereHas('actor', function($q) use($actor_id){
    $q->wherePivot('actor_id', '=', $actor_id);
})->get();

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