Laravel belongsToMany配合LeftJoin作用域无法获取分类翻译名问题

根因定位 #

该问题由两个关联查询的常见错误导致：

• Join条件字段歧义：两个模型的scopeTranslation方法中，关联条件使用了无表前缀的裸字段id。在预加载多对多关联categories时，ORM生成的SQL会自动关联中间表article_article_category，此时SQL上下文中存在多个表的id类字段，数据库无法识别裸写的id所属表，直接导致翻译表关联逻辑失效，无法获取article_category_translations表的name值。
• 同名字段覆盖风险：主表与翻译表存在id等同名字段，Join后如果不明确指定查询字段，会出现后加载字段覆盖前序字段值的问题，进一步引发数据异常。当前Article模型的同名Scope也存在相同问题，只是主查询场景下暂时没有字段冲突所以能正常输出文章名称，其他场景调用时同样会触发错误。

修复步骤 #

1. 给所有Join关联条件加表名前缀，消除字段歧义 #

分别修改两个模型的scopeTranslation方法，明确指定关联字段所属表：
修改ArticleCategory模型的Scope代码：

public function scopeTranslation($query)
{
    $query->leftJoin(
        'article_category_translations',
        'article_categories.id', // 明确指定关联字段为分类主表的id
        '=',
        'article_category_translations.article_category_id'
    )->where('article_category_translations.locale', config('app.locale'));
}

同步修正Article模型的Scope，避免后续其他场景报错：

public function scopeTranslation($query)
{
    $query->leftJoin(
        'article_translations',
        'articles.id', // 明确指定关联字段为文章主表的id
        '=',
        'article_translations.article_id'
    )->where('article_translations.locale', config('app.locale'));
}

2. （推荐）明确指定查询字段，避免同名字段覆盖 #

如果后续主表与翻译表新增同名字段（如status），Join查询会出现字段值覆盖的问题，建议在Scope中明确声明要查询的字段：

// ArticleCategory模型scopeTranslation补充select逻辑
public function scopeTranslation($query)
{
    $query->leftJoin(
        'article_category_translations',
        'article_categories.id',
        '=',
        'article_category_translations.article_category_id'
    )
    ->where('article_category_translations.locale', config('app.locale'))
    ->select([
        'article_categories.*',
        'article_category_translations.name'
    ]);
}

Article模型的Scope可做相同处理，指定查询articles.*与article_translations.name即可。

若后续article_categories主表新增name字段，需要给翻译表的name字段设置别名避免冲突，例如->selectRaw('article_categories.*, article_category_translations.name as category_name')，视图层对应调整为取$category->category_name即可。按照当前给出的表结构，分类主表只有id、status字段，无需额外设置别名。

3. 校验SQL确认修复结果 #

如果调整后仍有异常，可以在控制器查询时临时调用toSql()方法打印生成的原生SQL，检查两个关键点：

• 关联article_category_translations表的条件是否为article_categories.id = article_category_translations.article_category_id
• 查询字段列表中是否包含article_category_translations.name
  确认两点无误后，视图层的$category->name即可正常输出翻译表中的分类名称。

内容的提问来源于stack exchange，提问作者Денис Линник