Laravel多租户项目用Eloquent联表查询时出现user_id列歧义报错

• 歧义报错的触发逻辑完全来自你写的多租户全局作用域：当前addGlobalScope里的查询条件用了没有表名限定的短字段user_id
• 单表查询的时候因为只查一张表，数据库能明确找到对应的user_id字段，不会报错；但一旦做联表查询，不管是用join手动关联，还是用with/load做Eloquent关联，只要关联的其他业务表也存在user_id字段（绝大多数业务表的租户标识字段都是这个命名），SQL执行阶段就会因为找不到字段对应的归属表，抛出Column 'user_id' in where clause is ambiguous的错误。
• 全局作用域的逻辑会自动追加到所有该模型的查询语句末尾，这也是问题只会在联表场景触发、单表测试正常的核心原因。

核心修正：给全局作用域的查询条件绑定所属表名 #

把裸写的短字段查询，改成带当前模型对应表名的完整字段路径，从根源上消除字段歧义。不需要针对每个模型单独写逻辑，通过Eloquent Builder自带的方法动态取当前模型的表名即可，能适配所有复用该Trait的多租户模型。

修正后的Trait完整代码 #

<?php
namespace App\Traits;

use Illuminate\Database\Eloquent\Builder;

trait MultiTenintable
{
    public static function bootMultiTenintable()
    {
        if (auth()->check()) {
            static::creating(function ($model) {
                $model->user_id = auth()->id();
            });

            static::addGlobalScope('user_id', function (Builder $builder) {
                // 动态获取当前模型对应的数据库表名，拼接带表限定的查询字段
                $table = $builder->getModel()->getTable();
                return $builder->where($table . '.user_id', auth()->id());
            });
        }
    }
}

修正后的逻辑效果 #

• 不管联表过程中关联了多少张其他带user_id字段的表，这个租户约束条件永远只会匹配当前启用多租户Trait的目标表，不会和其他表的同名字段产生冲突。
• 动态取表名的写法可以通用在所有多租户模型上，比如后续把这个Trait挂到Order、Article、Comment等不同表的模型上，不需要单独修改作用域逻辑，不会出现条件指向错误表的问题。

实际开发的注意事项 #

• 绝对不要在作用域里硬编码表名：比如直接写死where('orders.user_id', auth()->id())，这种写法会导致把Trait用到其他模型时，查询条件错误指向orders表，直接击穿租户隔离边界。
• 如果需要做跨租户的全局统计类查询，可以通过Model::withoutGlobalScope('user_id')临时跳过对应表的租户约束，但这类操作必须严格做权限校验，避免出现跨租户的数据泄露风险。
• 如果联表的其他模型也启用了这套多租户Trait，不需要额外调整关联查询的代码，每个模型的全局作用域都会自动匹配自身表名生成正确的查询条件。

额外优化提示：当前Trait命名MultiTenintable存在拼写偏差，可调整为MultiTenantable，降低后续团队协作的维护成本。

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