Elasticsearch使用more_like_this报错：Expected field name but got START_OBJECT

这个错误我之前调试Elasticsearch查询时踩过坑！核心问题是你把more_like_this的位置放错了——它得作为查询类型节点（和match、match_phrase同级），而不是嵌套在不符合DSL规则的层级里。

错误原因分析 #

Elasticsearch的查询DSL要求：每个查询子句必须是「查询类型（如match）→ 配置对象」的键值对结构。如果你把more_like_this直接放在bool的顶层（比如和must平级），而不是作为must/should数组里的一个元素，就会触发Expected field name but got START_OBJECT 'more_like_this'这个语法错误。

举个你可能写错的反例：

// ❌ 错误写法：more_like_this直接放在bool下，违反DSL规则
[
    "index" => "videos",
    "from" => 0,
    "size" => 75,
    "body" => [
        "query" => [
            "bool" => [
                "must" => [
                    ["match" => ["gender" => 1]],
                    ["match_phrase" => [...]]
                ],
                "more_like_this" => [ // 这里错了！more_like_this必须是must/should里的元素
                    "fields" => ["title"],
                    "like" => "sample content"
                ]
            ]
        ]
    ]
]

正确写法示例 #

根据你的现有查询结构，把more_like_this加入到bool->must数组里，和其他match查询同级即可：

// ✅ 正确写法：将more_like_this作为bool->must的一个子查询
[
    "index" => "videos",
    "from" => 0,
    "size" => 75,
    "body" => [
        "query" => [
            "bool" => [
                "must" => [
                    ["match" => ["gender" => 1]],
                    ["match_phrase" => [...]],
                    // 正确放置more_like_this的位置
                    ["more_like_this" => [
                        "fields" => ["title", "description"], // 指定要匹配的字段
                        "like" => "your sample text here", // 匹配的参考文本
                        "min_term_freq" => 1, // 可选：最小词频阈值
                        "max_query_terms" => 10 // 可选：最大查询词数
                    ]]
                ]
            ]
        ]
    ]
]

如果more_like_this是你查询的核心（不需要和其他条件组合），也可以直接作为顶层查询使用：

// ✅ 另一种正确写法：直接用more_like_this作为顶层查询
[
    "index" => "videos",
    "from" => 0,
    "size" => 75,
    "body" => [
        "query" => [
            "more_like_this" => [
                "fields" => ["title", "description"],
                "like" => ["_id" => "your-document-id"], // 匹配指定ID的文档内容
                "min_doc_freq" => 1 // 可选：最小文档频率阈值
            ]
        ]
    ]
]

额外排查要点 #

• 检查PHP数组的语法：确保括号、逗号没有遗漏或错误，这也可能导致DSL解析失败。
• 验证more_like_this的内部配置：比如fields必须是数组，like可以是文本字符串、文档ID数组，甚至是完整的文档结构。

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