Elastic Cloud安装自定义插件报错：无法提取elasticsearch.version

针对报错：

Errors: [Could not extract [elasticsearch.version] from [plugin-descriptor.properties] of the given plugin file.]

提供以下解决步骤：

• 检查plugin-descriptor.properties格式

  • 确保elasticsearch.version=7.17.6键值对无多余空格，等号前后不能有空格
  • 确认文件编码为UTF-8且无BOM头，部分编辑器保存时会添加BOM导致解析失败
  • 检查文件内容完整，无乱码或缺失行

• 验证压缩包结构

  • 插件压缩包根目录必须直接包含plugin-descriptor.properties，不能嵌套在子文件夹中
  • 仅使用标准ZIP格式打包，不要用RAR、7Z等其他格式
  • 清理压缩包内的系统冗余文件（如.DS_Store、__MACOSX），避免干扰解析

• 核对版本一致性

  • 确认Elastic Cloud部署的集群版本确实为7.17.6，插件版本需与集群版本完全匹配
  • 若集群版本不同，修改plugin-descriptor.properties中的版本号后重新打包

• 重新打包上传

  • 手动重新打包插件文件，确保仅包含插件必需的文件
  • 上传前可本地解压检查结构是否符合要求

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