前言最近在做视频搜索功能需要在 Windows 环境下搭建 Elasticsearch 环境。本以为是个简单的任务结果踩了一堆坑记录一下供后人参考。环境信息操作系统: Windows 11ES 版本: 8.11.0IK 分词器版本: 8.11.0JDK: ES 自带踩坑过程坑 1路径空格问题问题: 把 ES 解压到D:\Program Files (x86)\目录下启动时各种报错。原因: 路径中包含空格和括号IK 分词器无法正确读取配置文件。解决: 把 ES 移到无空格路径如D:\elasticsearch-8.11.0坑 2安全认证配置问题: ES 8.x 默认开启安全认证启动后无法直接访问。解决: 修改config/elasticsearch.yml# 关闭安全认证 discovery.type: single-node xpack.security.enabled: false注意: 同时需要注释掉 SSL 相关配置否则还会报错。坑 3IK 分词器安装问题: 手动解压 IK 插件到 plugins 目录启动报错缺少plugin-descriptor.properties。原因: 下载的文件不对或者解压方式错误。正确安装方式:# 在线安装推荐 elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v8.11.0/elasticsearch-analysis-ik-8.11.0.zip # 或手动安装下载 zip 后解压到 plugins/ik/ 目录坑 4配置重复问题问题: 修改配置时不小心添加了重复的字段如http.host出现两次。解决: 仔细检查elasticsearch.yml确保没有重复配置项。坑 5keystore 残留问题: 之前配置过 SSL关闭安全认证后仍然报错找不到密码。解决: 删除config/elasticsearch.keystore文件重启 ES。最终配置# Elasticsearch Configuration # 单机模式 discovery.type: single-node # 关闭安全认证 xpack.security.enabled: false # 允许跨域 http.cors.enabled: true http.cors.allow-origin: * # 绑定地址 http.host: 0.0.0.0 # 注释掉以下配置如果存在 # xpack.security.enrollment.enabled: true # xpack.security.http.ssl.enabled: true # xpack.security.transport.ssl.enabled: true # cluster.initial_master_nodes: [xxx]验证安装启动 ES 后访问curl http://localhost:9200返回 JSON 说明成功。验证 IK 分词器# 创建索引时使用 ik_max_word 分词器 PUT /test { mappings: { properties: { content: { type: text, analyzer: ik_max_word } } } } # 测试分词 POST /test/_analyze { analyzer: ik_max_word, text: 中华人民共和国 }总结路径不要有中文、空格、特殊字符IK 分词器版本必须和 ES 版本匹配修改配置时仔细检查避免重复有问题先看日志一般在logs/elasticsearch.log参考Elasticsearch 官方文档IK 分词器 GitHub如果这篇文章帮到你请点个赞