drupal 在多语言站点中因 search api 的翻译过滤器配置不当，导致 solr 索引遗漏节点、搜索结果不全及排序异常，本文提供精准诊断步骤与安全修复方案。
drupal 在多语言站点中因 search api 的翻译过滤器配置不当，导致 solr 索引遗漏节点、搜索结果不全及排序异常，本文提供精准诊断步骤与安全修复方案。
在使用 Drupal 构建多语言站点并集成 Solr 作为后端搜索引擎时，一个常见但易被忽视的问题是：Search API 索引未能正确包含所有语言变体的节点。典型表现为——执行空查询（如 ?filter[search_api_fulltext]=）仅返回部分节点（例如 3 条而非预期的 6 条），而单独按标题或字段精确检索时却能查到全部内容；同时，基于字段（如 created 或 title）的排序结果出现错乱。这并非 Solr 配置或 JSON:API 模块缺陷，而是 Search API 视图（View）或索引处理器中的语言上下文干扰所致。
核心原因在于 Search API 索引配置中启用了 Translation filter（翻译过滤器），该过滤器默认绑定当前用户语言或站点默认语言（如 English），从而在索引构建或查询阶段主动排除其他语言版本的节点，造成“索引可见性丢失”。
✅ 正确修复步骤如下：
- 进入 Admin → Configuration → Search and metadata → Search API
- 找到您正在使用的 Solr 服务器对应的索引（如
solr_index），点击 Edit → Filters - 在 Filter criteria 区域，查找名为 "Content translation" 或 "Translation filter" 的过滤器
- 取消勾选该过滤器（⚠️ 注意：不是禁用整个过滤器插件，而是取消其在当前索引中的启用状态）
- 保存配置，并重新索引全部内容（可通过
drush sapii solr_index或管理界面触发）
# 命令行快速重索引示例（推荐） drush sapii solr_index --force
? 补充说明与最佳实践：
- 若需支持多语言搜索结果聚合（如用户搜索时返回所有语言匹配项），绝对不应启用 Translation filter；该过滤器仅适用于「仅显示当前语言内容」的特定场景（如区域化门户首页）。
- 确保
search_api_solr模块已启用Language字段映射（默认开启），Solr schema 中language字段应为string类型且multiValued="false"。 - 使用 JSON:API Search API 时，避免在请求中硬编码
langcode过滤条件；如需语言筛选，应在客户端逻辑中处理，而非依赖索引层过滤。 - 排序异常通常由缺失统一排序字段（如未对
title或body启用sort属性）引起，可在 Search API 索引的 Fields → Sort options 中为关键字段启用Sortable。
完成上述调整后，空查询将返回完整节点集，跨语言字段排序也将恢复一致性和准确性——这是多语言 Drupal + Solr 架构稳定运行的关键基础配置。
