怎么安装elasticsearch中文分词插件Synonym-Analysis

发布时间：2021-11-15 11:01:53 作者：iii
来源：亿速云阅读：495

# 怎么安装Elasticsearch中文分词插件Synonym-Analysis

## 前言

Elasticsearch作为一款强大的开源搜索引擎，在处理中文文本时往往需要借助分词插件来提升搜索效果。Synonym-Analysis是一款支持同义词扩展的中文分词插件，能够显著改善中文搜索体验。本文将详细介绍如何从零开始安装配置该插件，涵盖环境准备、安装步骤、配置优化及常见问题解决。

---

## 一、环境准备

### 1.1 确认Elasticsearch版本
在安装插件前，必须确保插件版本与Elasticsearch版本兼容：
```bash
# 查看Elasticsearch版本
curl -XGET 'http://localhost:9200'

输出示例：

{
  "version" : {
    "number" : "7.17.3"
  }
}

注意：Synonym-Analysis插件不同分支对应不同ES版本： - master分支：ES 7.x - 6.x分支：ES 6.x - 5.x分支：ES 5.x

1.2 安装必要依赖

# 安装JDK（需1.8+）
sudo apt install openjdk-11-jdk

# 安装Maven（用于编译插件）
sudo apt install maven

二、插件安装步骤

2.1 源码编译安装（推荐）

步骤1：下载源码

git clone https://github.com/elasticsearch-analysis/synonym-analysis.git
cd synonym-analysis

步骤2：切换对应分支

# 以ES 7.x为例
git checkout master

步骤3：编译打包

mvn clean package

成功编译后会在target/releases/生成zip包：

elasticsearch-analysis-synonym-7.17.3.zip

步骤4：安装插件

# 进入ES插件目录
cd /usr/share/elasticsearch/bin/

# 执行安装
sudo ./elasticsearch-plugin install file:///path/to/elasticsearch-analysis-synonym-7.17.3.zip

2.2 直接安装（适用于已编译版本）

sudo ./elasticsearch-plugin install https://github.com/elasticsearch-analysis/synonym-analysis/releases/download/v7.17.3/elasticsearch-analysis-synonym-7.17.3.zip

三、配置同义词分词器

3.1 创建索引配置

PUT /my_index
{
  "settings": {
    "analysis": {
      "filter": {
        "my_synonym": {
          "type": "synonym",
          "synonyms_path": "analysis/synonym.txt"
        }
      },
      "analyzer": {
        "my_analyzer": {
          "tokenizer": "ik_max_word",
          "filter": ["my_synonym"]
        }
      }
    }
  }
}

3.2 同义词文件配置

在ES配置目录创建synonym.txt：

# 格式示例（每行一组同义词）
手机,移动电话,cellphone
番茄,西红柿

四、验证安装效果

4.1 测试分词效果

GET /my_index/_analyze
{
  "analyzer": "my_analyzer",
  "text": "我的手机坏了"
}

预期输出应包含同义词扩展：

{
  "tokens" : [
    {
      "token" : "手机",
      "synonym" : true
    },
    {
      "token" : "移动电话",
      "synonym" : true
    }
  ]
}

4.2 实际搜索测试

GET /my_index/_search
{
  "query": {
    "match": {
      "content": "移动电话"
    }
  }
}

应能匹配包含”手机”的文档。

五、高级配置技巧

5.1 动态更新同义词

无需重启ES，通过API刷新：

POST /my_index/_reload_search_analyzers

5.2 多同义词文件支持

"filter": {
  "my_synonym": {
    "type": "synonym",
    "synonyms_path": [
      "analysis/synonym_product.txt",
      "analysis/synonym_tech.txt"
    ]
  }
}

5.3 同义词扩展规则

格式类型	示例	说明
显式映射	手机=>智能手机	单向扩展
等价替换	手机,移动电话	双向扩展
正则表达式	~(.*)手机=>$1智能手机	模式匹配

六、常见问题解决

6.1 插件加载失败

现象：启动时报NoClassDefFoundError
解决： 1. 确认ES与插件版本严格匹配 2. 重新编译时清理旧版本：

mvn clean

6.2 同义词未生效

排查步骤： 1. 检查synonym.txt文件权限 2. 确认文件编码为UTF-8无BOM 3. 查看ES日志：

tail -f /var/log/elasticsearch/elasticsearch.log

6.3 性能优化建议

同义词数量超过10万时：
- 使用synonym_graph代替synonym
- 启用update_all_types参数
内存配置调整：

# config/jvm.options
-Xms4g
-Xmx4g

七、与其他插件协同工作

7.1 配合IK分词器

"analyzer": {
  "my_analyzer": {
    "type": "custom",
    "tokenizer": "ik_smart",
    "filter": ["my_synonym"]
  }
}

7.2 与Pinyin插件集成

实现拼音+同义词搜索：

"filter": {
  "pinyin_synonym": {
    "type": "synonym",
    "synonyms": ["shouji,手机", "sj,手机"]
  }
}

结语

通过本文的详细指导，您应该已经成功安装并配置了Synonym-Analysis插件。该插件能显著提升中文搜索的相关性，特别是在电商、内容检索等场景下效果尤为明显。建议定期维护同义词库，结合实际业务需求持续优化搜索体验。

延伸阅读：
- Elasticsearch官方文档
- 同义词库推荐：同义词词林扩展版 “`

注：本文实际约2500字，可根据需要补充以下内容扩展： 1. 具体版本兼容性对照表 2. 不同操作系统下的路径差异 3. 性能测试数据对比 4. 集群环境下的部署建议