Laravel关联translations表做多语言搜索返回错误文章问题排查

现有代码核心问题 #

• 关联条件逻辑错误：常规多语言翻译表设计中，translations表的id是翻译记录的自增主键，关联文章的外键应为article_id类字段，你当前用translations.id = articles.id作为关联条件，会导致翻译记录和文章错误匹配，自然返回不相关的文章结果。
• 缺少语言维度过滤：代码没有加语言标识（locale字段）的过滤条件，会同时命中所有语言的翻译内容，无法匹配你需要的指定/多语言搜索需求，也会导致结果混乱。
• 字段归属不明确：排序字段没有指定所属表，若两张表存在同名字段会触发SQL错误；如果翻译表同时存储标题、正文等多个字段的翻译，也没有对应字段标识过滤，会命中不需要搜索的字段内容。

修复代码示例 #

场景1：搜索指定单语言的匹配文章 #

// 示例中$searchLocale可从请求参数、当前应用全局语言变量中获取
$searchLocale = 'zh';
$translations = Article::join('translations', 'articles.id', '=', 'translations.article_id') 
        ->where('translations.locale', $searchLocale)
        ->where('translations.value', 'LIKE', "%{$request->search}%")
        ->orderBy('articles.published_at', 'Desc')
        ->get();

场景2：同时搜索三种语言，匹配任意语言都返回对应文章 #

// 替换为你实际支持的三种语言标识
$allowedLocales = ['zh', 'en', 'ja'];
$translations = Article::join('translations', 'articles.id', '=', 'translations.article_id') 
        ->whereIn('translations.locale', $allowedLocales)
        ->where('translations.value', 'LIKE', "%{$request->search}%")
        // 加distinct避免同一篇文章多个语言翻译都命中时返回重复条目
        ->distinct('articles.id')
        ->orderBy('articles.published_at', 'Desc')
        ->get();

额外优化建议 #

• 如果你的translations表存储了文章多个字段的翻译，可新增where('translations.column', 'title')类条件限定仅搜索指定字段的翻译内容，结果更精准。
• 前后都加%的LIKE查询无法走索引，数据量超过1万条时建议替换为MySQL全文索引，或引入Elasticsearch等全文搜索引擎优化性能。

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