ElasticSearch PHP查询改写求助：多字段匹配与用户过滤

问题核心错误 #

你现有查询的主要问题：

• filter内的两个term默认是AND逻辑，但需求是OR，必须用bool.should包裹这两个筛选条件
• 直接用term: { "_users": [] }无法正确匹配空数组，需要用脚本判断数组长度
• 文本匹配用should会导致空搜索文本时返回所有文档，不符合常规搜索逻辑

正确的ElasticSearch查询DSL #

{
  "query": {
    "bool": {
      "must": [
        {
          "multi_match": {
            "query": "你的搜索文本",
            "fields": ["content.title", "content.short_text"],
            "type": "best_fields"
          }
        }
      ],
      "filter": {
        "bool": {
          "should": [
            {
              "terms": {
                "_users": [1]
              }
            },
            {
              "script": {
                "source": "doc['_users'].size() == 0"
              }
            }
          ],
          "minimum_should_match": 1
        }
      }
    }
  }
}

逻辑说明 #

1. 文本匹配：用bool.must确保只有匹配content.title或content.short_text的文档才会被返回；如果需要空文本时返回所有符合筛选条件的文档，可把must改成should并保留minimum_should_match: 1
2. 用户筛选：
   • terms: { "_users": [1] }：匹配_users数组包含指定用户ID的文档（数组类型字段用terms比term更准确）
   • 脚本判断doc['_users'].size() == 0：精准匹配_users为空数组的文档
   • bool.should+minimum_should_match:1实现两个筛选条件的OR逻辑

修正后的PHP代码 #

public static function search(string $text = '', int $user = 0): array
{
    try {
        $model = new someModelClass();
        $fields = ['content.title', 'content.short_text'];
        
        $query = [
            'bool' => [
                'filter' => [
                    'bool' => [
                        'should' => [],
                        'minimum_should_match' => 1
                    ]
                ]
            ]
        ];
        
        // 非空搜索文本时添加匹配条件
        if (!empty($text)) {
            $query['bool']['must'] = [
                'multi_match' => [
                    'query'  => $text,
                    'fields' => $fields,
                    'type'   => 'best_fields'
                ]
            ];
        }
        
        // 指定用户ID时添加匹配条件
        if ($user > 0) {
            $query['bool']['filter']['bool']['should'][] = [
                'terms' => ['_users' => [$user]]
            ];
        }
        
        // 添加空数组匹配条件
        $query['bool']['filter']['bool']['should'][] = [
            'script' => [
                'source' => "doc['_users'].size() == 0"
            ]
        ];
        
        $result = $model::find()->query($query)->all();
        return $result;
    } catch (Exception $e) {
        throw new Exception($e->getMessage());
    }
}

代码优化点 #

• 增加空搜索文本判断，避免无意义的全量返回
• 用terms适配数组类型的_users字段
• 灵活处理$user=0的场景（无需匹配指定用户时自动跳过）

内容的提问来源于stack exchange，提问作者Mít