Elastic Search自动补全（suggest completion）失效问题求助

问题概述 #

升级ElasticSearch及PHP API多个版本后，词条自动补全功能失效，配置参考线上示例但仍报错：

• 直接搜索search_suggest字段时：no mapping found for field [search_suggest]
• 改为搜索search_suggest.input时：Field [search_suggest.input] is not a completion suggest field

相关配置与代码 #

映射配置

'mappings' => array(
    '_source' => array( 'enabled' => true ),
    'dynamic' => false,
    'properties' => array(
        'search_term' => array(
            'type' => 'text',
            'analyzer' => 'myNGramAnalyzer',
            'search_analyzer' => 'standard'
        ),
        'search_suggest' => array(
            'type' => 'completion',
            'analyzer' => 'autocomplete',
            'search_analyzer' => 'standard'
        ),
        'week_searches' => array( 'type' => 'integer' ),
    )
)

索引代码

$params['body'][] = array(
    'search_term' => $clean_term,
    'search_suggest' => array(
        array(
            'input' => $clean_term,
            'payload' => $document,
            'weight' => $weight
        )
    ),
    'week_searches' => "$week"
);

搜索代码

$params['body']['suggest']['autocomplete'] = [
    'text' => $this->search_term,
    'completion' => [
        'field' => 'search_suggest',
        'size' => self::TERM_RESULT_SIZE,
        'fuzzy' => [ 'fuzziness' => 0 ]
    ]
];

排查步骤 #

1. 验证索引映射是否真实生效 #

通过ElasticSearch API查看目标索引的实际映射，确认search_suggest字段是否存在且类型为completion：

GET /your_index_name/_mapping

如果该字段不存在，说明索引创建时映射未正确应用——由于配置了dynamic: false，新字段不会自动生成映射，需确保创建索引时完整传递了上述mapping配置。

2. 修正索引数据的结构 #

当前索引代码中search_suggest的值是嵌套数组（array(array(...))），不符合ElasticSearch completion字段的结构要求。completion字段接受单个建议对象，或多个建议对象的数组（而非嵌套数组），修改索引代码如下：

$params['body'][] = array(
    'search_term' => $clean_term,
    // 单个建议对象（正确格式）
    'search_suggest' => array(
        'input' => $clean_term,
        'payload' => $document,
        'weight' => $weight
    ),
    'week_searches' => "$week"
);

若需添加多个输入项，可将input设为数组：

'search_suggest' => array(
    'input' => [$clean_term, $synonym_term], // 多个输入词
    'payload' => $document,
    'weight' => $weight
)

3. 检查版本兼容性 #

• ElasticSearch版本差异：不同大版本的completion字段语法、查询格式可能存在变化（如7.x/8.x对suggest的处理逻辑调整），需确保查询代码符合当前ES版本的要求。
• PHP客户端与ES版本匹配：elasticsearch-php客户端版本需与ES服务器大版本一致（如ES 8.x需使用8.x系列的PHP客户端），版本不匹配可能导致数据序列化、API调用异常，进而引发映射识别失败。

4. 重新生成索引（若上述步骤无效） #

如果映射确实存在但仍报错，可能是旧索引数据与新映射不兼容，建议：

1. 创建新索引并应用正确的映射配置
2. 重新导入数据到新索引
3. 切换搜索请求指向新索引

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