MAC（M1）elasticsearch8.6.1安装ik分词器报错Plugin [ik] is missing a descriptor properties file

最新推荐文章于 2025-08-21 11:58:25 发布
原创 最新推荐文章于 2025-08-21 11:58:25 发布 · 1.8k 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#macos #中文分词 #elasticsearch

在尝试按照教程在elasticsearch的plugins目录下安装ik分词器时遇到错误：Plugin[ik]ismissingadescriptorpropertiesfile。正确的方法是直接将ik分词器的zip文件解压到elasticsearch/plugins目录下，得到的文件夹elasticsearch-analysis-ik-8.6.1即为所需。

报错：

根据教程，在elasticsearch/plugins中创建文件夹ik，解压ik分词器zip文件到ik文件夹中，报错IllegalStateException: Plugin [ik] is missing a descriptor properties file

解决方法：

直接在elasticsearch/plugins下解压ik分词器zip文件，解压后是一个文件夹，名为elasticsearch-analysis-ik-8.6.1。

Liz_200
关注
Mac 使用Docker安装Elasticsearch、Kibana 、ik分词器、head
AKANGYONG的博客
06-04 1113
Mac 超详细Docker安装Elasticsearch、Kibana
windows安装Elasticsearch后使用ik分词器报错解决办法
qq_45784913的博客
01-11 1128
咋一看以为是es对应的jdk自带的权限不足导致的，查看jdk自带的文件查看权限没有发现问题：D:\Code Study\Technology\ES\elasticsearch-8.11.1\jdk\lib\security下的default.policy。大意是说下载离线地图超时了，暂时不需要的话可以在设置中选择默认不下载。添加配置设置为false即可。
windows 搭建elasticsearch环境
A2830563的专栏
11-16 3281
elasticsearch
Elasticsearch 8.10安装（windows11）
weixin_42930616的博客
08-21 1137
OK，经过三天的踩坑，以及碰见的n篇傻波的贴子，博主最终还是找到了一篇比较靠谱的贴子，根据这篇帖子完成了Elasticsearch 8.10安装 和 IK分词器 插件的安装。
es安装ik分词器报错：plugin-descriptor.properties
RabbitJava的博客
07-01 443
然后发现离我版本最近的ik安装包只有7.11.14里面才有这个properties，那到这里了，我邪魅一笑，这不是手到擒来嘛哈哈哈哈。结果解压之后发现还是没有这个properties文件。然后我有各种找啊找啊，结果发现对应es的版本全在这里。直接告诉我版本不对呜呜呜。我上早八，真的急死了。报错找不到这个properties文件。解压之后放在这里，一切ok。我的es版本7.11.1。
es加入分词插件无法启动Plugin [elasticsearch-analysis-ik-8.5.2.zip] is missing a descriptor
JavaBigData的博客
11-08 364
在git下载es相同版本的分词器，解压放入插件目录，需有配置文件
es5.0 安装ik中文分词器 mac
weixin_34018202的博客
07-26 180
es5.0集成ik中文分词器,网上资料很多,但是讲的有点乱,有的方法甚至不能正常运行此插件 特别注意的而是,es的版本一定要和ik插件的版本相对应: 1,下载ik 插件: https://github.com/medcl/elasticsearch-analysis-ik/releases(找到合适在即es版本) 解压zip包,并将其复制到es的plugins文件夹下,并将文件夹改名为...
elasticsearch 7.6.2版本安装elasticsearch-analysis-ik插件报plugin-descriptor.properties找不到错误
热门推荐
chenlin_china的博客
04-10 1万+
在centos 7虚拟机中安装了elasticsearch 7.6.2版本，再在网上下载对应elasticsearch-analysis-ik-7.6.2.zip版本，解压至plugins文件夹后启动报java.nio.file.NoSuchFileException: /usr/local/src/elasticsearch-7.6.2/plugins/config/plugin-descrip...
Elasticsearch安装IK中文分词器
11-04
在Elasticsearch中安装IK分词器是一个相对简单的操作。首先，需要下载与当前Elasticsearch版本相对应的IK分词器插件包。根据给定的信息，我们正在处理的Elasticsearch版本是7.9.3，对应的IK分词器插件包名为elastic...
elasticsearch-analysis-ik-8.9.0 ik分词器
10-11
标题中提到的elasticsearch-analysis-ik-8.9.0代表的是在Elasticsearch 8.9.0版本中使用的IK分词器。IK分词器是一个基于Java语言编写的Elasticsearch插件，提供了中文分词功能。它支持两种分词模式：智能分词和普通...
elasticsearch-7.17.10-x86-64已安装插件 ik分词器、head、ingest-attachment
02-04
1. **ik分词器**：这是Elasticsearch中非常流行的中文分词器，由“智慧眼”团队开发。ik分词器支持多种分词模式，包括精确模式、全模式、关键词模式等，能够满足不同场景下的中文文本处理需求。它的存在使得Elastic...
elasticsearch7.8.0版本的IK分词器
12-30
9. **插件安装与升级**: 安装 IK 分词器非常简单，只需将 `elasticsearch-analysis-ik-7.8.0` 文件解压后放入 Elasticsearch 的 plugins 目录下，重启服务即可。如果需要升级，只需替换新的插件版本并重新启动。 在...
elasticsearch引入elasticsearch-analysis-ik-7.4.0插件报错plugin-descriptor.properties
xhdll的博客
07-16 1205
plugin-descriptor.properties
elasticsearch引入elasticsearch-analysis-ik-7.12.0插件报错plugin-descriptor.properties
yuguang的博客
04-12 2439
1.报错内容 2.报错原因 如下图所示，下载的zip文件解压之后的情况，这里是不能放到elasticsearch的plugins中的。 分析：由于是java开发的分词器，这里很明显是maven项目的目录结构。所以要执行打包命令，生成对应的发布的包 正确的目录应该是 3.解决办法 在以下这个目录中执行：mvn clean install 最后目录才是需要的包：/target/release/ 解压后可见： ...
ElasticSearch插件plugin ik分词器，报错plugin-descriptor.properties
weixin_46000937的博客
08-15 3852
ES日志中报错plugin-descriptor.properties NoSuchFileException。
[ES]mac安装es、kibana、ik分词器
胖胖的博客
08-28 1586
可选的有standard、english、chinese但是他们的中文都是一个字分一个词。必须创建，直接解压到plugins目录下会报错。点击这个，在里面写就行了。
ES-Mac OS环境搭建-ik中文分词器
weixin_30341745的博客
04-21 400
下载 从github下载ik中文分词器，点击地址，需要注意的是，ik分词器和elasticsearch版本必须一致。 安装 下载到本地并解压到elasticsearch中的plugins目录内即可。 测试 测试，进入kibana中的Dev Tools中，在Console中输入： ps：ik插件的生效需要重启elasticsearch。 GET _ana...
mac 安装Elasticsearch、Kibana和IK分词器
weixin_43405771的博客
06-25 2756
mac安转es
docker安装elasticsearch后安装ik分词器报错ava.lang.IllegalArgumentException:可能是ik分词器版本和es不匹配
百万雄师过大江
06-27 946
docker安装elasticsearch后安装ik分词器报错 2021-06-22T08:33:35.980291839Z [2021-06-22T08:33:35,976][INFO ][o.e.n.Node ] [h5wetQC] JVM arguments [-Xms1g, -Xmx1g, -XX:+UseConcMarkSweepGC, -XX:CMSInitiatingOccupancyFraction=75, -XX:+UseCMSInitiatingOccupan
Plugin [elasticsearch-analysis-ik-9.1.3.zip] is missing a descriptor properties file.
最新发布
09-19
<think> 首先，用户的问题是：“我想查找解决Elasticsearch IK插件（版本9.1.3）缺少描述符属性文件问题的方法 请问Elasticsearch IK插件9.1.3版本缺少描述符属性文件的解决办法”。我需要基于提供的站内引用来回答。 回顾引用内容： - 引用[1]：关于安装elasticsearch-analysis-ik-1.9.1版本的步骤，包括git clone、mvn命令编译和打包。 - 引用[2]：关于Elasticsearch中查看Index下所有文档的命令和使用pretty=true参数。 - 引用[3]：关于修改IK分词器插件以从数据库加载词库的步骤，包括获取源码、设置数据库连接、编写函数、修改加载代码、添加定时任务、编译和安装。 - 引用[4]：关于参数过滤、动态路由和缓存的讨论，提到在网关本地缓存数据以减少redis负载。 用户的问题具体是IK插件9.1.3版本缺少描述符属性文件的问题。描述符属性文件通常是指插件的描述文件，比如plugin-descriptor.properties文件，这在Elasticsearch插件中是必需的，因为它定义了插件的元数据如名称、版本、描述等。 从引用中，最相关的是引用[3]，因为它涉及IK插件的源码修改和编译。引用[1]也提到了IK插件的编译过程，但使用的是旧版本1.9.1。 关键点： - IK插件的描述符属性文件应该存在于插件的源码或打包后的zip文件中。 - 如果缺少，可能是编译过程中出了问题，或者文件没有被正确包含。 用户在问题中指定了版本9.1.3，所以我需要确保回答针对这个版本。 基于提供的引用： - 引用[3]描述了如何修改IK源码来定制词库加载。这涉及到编译插件，这可能与描述符文件相关。 - 编译插件通常通过Maven（如引用[1]中提到的mvn package命令），这会生成zip文件，其中应该包含plugin-descriptor.properties文件。 可能的原因是： - 在编译时，描述符文件没有被正确生成或包含。 - 用户可能没有从官方库克隆源码，或者源码有缺失。 - 或者，在安装插件时，文件没有被正确部署。 解决方法： 1. **确认源码完整性**：确保从官方GitHub仓库克隆IK插件的源码（如引用[1]和[3]中提到的）。对于版本9.1.3，应该克隆对应分支或标签的源码。 - 引用[1]：`git clone https://github.com/medcl/elasticsearch-analysis-ik` - 检查是否有plugin-descriptor.properties文件在源码中。 2. **编译插件**：使用Maven编译（如引用[1]：`mvn clean package`）。 - 编译后，在target目录中生成的zip文件应该包含所有必要的文件，包括描述符属性文件。 3. **检查文件存在**：如果在编译后zip文件中缺少描述符文件，可能需要手动添加或确保构建脚本正确。 - 在IK插件的源码中，通常有plugin-descriptor.properties文件在适当位置（如src/main/resources目录）。 4. **安装插件**：安装生成的zip文件到Elasticsearch（如使用elasticsearch-plugin install命令）。 - 确保插件安装正确，Elasticsearch启动时没有关于缺少描述符文件的错误。 5. **自定义修改**：如果用户进行了自定义修改（如引用[3]中提到的），确保修改没有破坏文件的生成或路径。 回答结构： - 使用中文回答。 - 结构清晰：逐步解决问题。 - 遵守系统指令：行内数学用$...$，独立公式用$$...$$（但这里可能不涉及数学公式）。 - 末尾添加引用标识。 - 生成相关问题。 步骤： 1. **引言**：简述问题并确认版本。 2. **解决步骤**： - 步骤1：获取正确版本的源码。 - 步骤2：编译插件。 - 步骤3：检查编译输出。 - 步骤4：安装插件。 - 步骤5：处理常见问题（如文件缺失）。 3. **结尾**：总结。 4. **生成相关问题**：基于主题。 引用来源： - 在回答中，自然地添加引用标识到引用内容末尾。 - 例如，提到编译步骤时引用[1]，提到源码修改时引用[3]。 生成相关问题： - 例如： - IK插件如何从数据库加载词库？ - 如何优化IK插件的性能？ - 为什么Elasticsearch插件需要描述符属性文件？ 最终回答： - 确保真实可靠。 </think> ### Elasticsearch IK插件9.1.3版本缺少描述符属性文件的解决办法 Elasticsearch插件（如IK分词器）的`plugin-descriptor.properties`文件是核心元数据文件，定义了插件的名称、版本、描述符等属性。缺少此文件会导致插件安装失败或Elasticsearch启动时报错（例如`java.nio.file.NoSuchFileException`）。以下是基于常见实践和参考引用的分步解决方案，适用于IK插件9.1.3版本。 #### 步骤1: 获取正确版本的IK插件源码 - 从官方仓库克隆源码，确保分支匹配9.1.3版本： ```bash git clone https://github.com/medcl/elasticsearch-analysis-ik cd elasticsearch-analysis-ik git checkout v9.1.3 # 切换到9.1.3版本的分支或标签 ``` 如果官方仓库无直接标签，可查询兼容分支或手动调整源码。此步骤确保文件完整性，避免源码缺失导致属性文件丢失[^1][^3]。 #### 步骤2: 检查并修复描述符属性文件 - 在源码目录中，确认`src/main/resources/plugin-descriptor.properties`文件是否存在： - 如果文件缺失，手动创建该文件并填充标准内容（示例内容如下）： ```properties name=analysis-ik description=IK Analysis for Elasticsearch version=9.1.3 elasticsearch.version=9.1.3 # 必须与Elasticsearch版本一致 java.version=11 # 根据Java环境调整 classname=org.elasticsearch.plugin.analysis.ik.AnalysisIkPlugin ``` - 修改`pom.xml`文件，确保Maven构建包含此资源文件（引用[3]中提到了定制源码的通用方法）[^3]。 - **关键点**：Elasticsearch 7.x+要求版本严格匹配，确认`elasticsearch.version`属性与实际Elasticsearch版本一致。 #### 步骤3: 编译并打包插件 - 使用Maven编译插件（确保Java和Maven环境配置正确）： ```bash mvn clean mvn compile mvn package # 生成elasticsearch-analysis-ik-9.1.3.zip文件 ``` 编译后，在`target/releases/`目录检查zip文件是否包含`plugin-descriptor.properties`。若缺失，重复步骤2修复[^1][^3]。 #### 步骤4: 安装插件到Elasticsearch - 停止Elasticsearch服务，然后安装插件： ```bash bin/elasticsearch-plugin install file:///path/to/elasticsearch-analysis-ik-9.1.3.zip ``` 安装后，验证插件是否加载： ```bash curl -XGET 'http://localhost:9200/_cat/plugins?v' # 类似引用[2]的查询命令 ``` 确保输出中包含IK插件信息[^2]。 #### 步骤5: 处理常见错误场景 - **错误：插件加载失败**：若Elasticsearch报错`missing descriptor properties`，检查： - 文件权限：确保插件目录（如`plugins/analysis-ik/`）有读写权限。 - 版本冲突：IK插件版本必须匹配Elasticsearch主版本（例如9.1.3插件用于9.1.3集群）。 - 热更新问题：如果修改了词库（如引用[3]中的数据库加载），确保自定义代码未删除描述符文件[^3]。 - **替代方案**：如果编译失败，下载官方预编译包（如从[Maven仓库](https://repo1.maven.org/maven2/org/elasticsearch/plugin/analysis-ik/)）并手动添加属性文件。 #### 总结 通过以上步骤，您应能解决IK插件9.1.3缺少描述符属性文件的问题。核心是确保源码完整、文件存在且版本兼容。如果问题持续，检查Elasticsearch日志（`logs/elasticsearch.log`）获取详细错误信息。对于大规模部署，建议结合引用[4]的缓存机制优化插件加载性能[^4]。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值