Java项目集成IK分词器需服务端安装对应版本IK插件、索引创建时显式指定analyzer（如"ik_smart"），客户端使用RestHighLevelClient发送查询时须在matchQuery等处调用.analyzer()方法透传分词器，否则默认走标准分词；Spring Data Elasticsearch中@Field(analyzer="ik_max_word")仅在自动建索引时生效，已有索引需手动重建；环境不一致（如测试/生产未装IK）是上线分词失败主因，须curl验证/_analyze接口。
Java项目里怎么加IK分词器支持
ES本身不带IK，得靠插件和客户端配合。Java端不能只靠RestHighLevelClient发请求就完事，分词器生效依赖两个地方：服务端装了IK插件、索引创建时显式指定analyzer和tokenizer。
- 别在没装IK的ES实例上测试
ik_smart，会直接报illegal_argument_exception: analyzer [ik_smart] not found - 索引mapping里必须写明
"analyzer": "ik_smart"，光在查询时传analyzer=ik_smart参数，对字段建模无效 - Spring Data Elasticsearch 4.x+ 默认用
RestHighLevelClient，它不自动加载IK词典，词典热更新得靠ES服务端配置ik/conf/IKAnalyzer.cfg.xml，Java侧无感知
RestHighLevelClient怎么发带IK的搜索请求
客户端不用改依赖，但构造查询时容易漏掉关键参数。IK分词效果是否触发，取决于查询DSL里有没有把analyzer透传给ES，而不是Java代码里写了“ik”两个字。
- 使用
matchQuery时，必须调用.analyzer("ik_smart")，否则走默认标准分词器 -
termQuery这类不分词查询，加analyzer无效，别浪费时间试 - 聚合查询（
aggregation）如果对text字段做terms聚合，得先确认该字段开启了fielddata=true，否则报Fielddata is disabled on text fields - 示例：
matchQuery("content", "人工智能").analyzer("ik_max_word")
Spring Data Elasticsearch集成IK的坑点
自动配置容易掩盖底层细节。Spring Boot Starter默认帮你配好RestHighLevelClient，但不会替你处理IK特有的索引生命周期问题。
- @Document注解里的
indexName只是逻辑名，真正创建索引还得手动执行IndexOperations.create()，否则mapping里写的analyzer根本不会落地 - 实体类字段用
@Field(type = Text, analyzer = "ik_max_word")，仅在自动创建索引时生效；已有索引再加这个注解，重启应用也无效 - 升级ES版本后，IK插件必须对应重装（比如ES 8.10 要用 IK 8.10），否则启动报
plugin requires at least version
为什么本地跑通了，上线就分词失败
最常见原因是环境不一致：开发机ES装了IK，测试/生产环境没装，或者装了但版本不对。Java客户端完全感知不到服务端缺插件，错误只在第一次查词时暴露。
立即学习“Java免费学习笔记（深入）”；
- 上线前务必curl验证：
GET /_analyze?analyzer=ik_smart&text=测试，看返回有没有tokens数组 - Docker部署ES时，别只COPY官方镜像，得自己build含IK的镜像，或用
elasticsearch-plugin install命令安装（注意容器内路径权限） - K8s里ES Pod日志搜
ik和Plugin loaded，确认插件加载成功，不是“Plugin installed”就以为完事了
analyzer的请求都会静默退化成标准分词，连warning都不打。 
