Easy-Es常见问题与解决方案：开发者必看的避坑指南
在使用Easy-Es进行Elasticsearch开发时，开发者常常会遇到各种问题。本文将详细介绍Easy-Es的常见问题及解决方案，帮助开发者快速避坑，提升开发效率。
1. 版本兼容性问题
1.1 Elasticsearch版本选择
Easy-Es底层使用了Elasticsearch官方的RestHighLevelClient，版本为7.10。因此，推荐使用7.x版本的Elasticsearch，以获得最佳兼容性。目前实测7.x版本都可以完美兼容。
1.2 SpringBoot版本选择
Easy-Es底层使用的Springboot版本为2.5.4。推荐用户使用相同版本的Springboot，实测2.3.x-2.6.x版本也可以兼容。为避免不必要的麻烦，建议尽量与框架内置版本保持一致。
2. 索引类型问题
2.1 keyword类型与text类型的区别
- keyword类型：适用于精确匹配、排序、聚合等操作，如eq()、like()、distinct()等API。
- text类型：适用于分词查询，如match()等API。需要指定合适的分词器以获得理想效果。
2.2 同时需要两种类型的解决方案
当一个字段既需要精确匹配又需要分词查询时，可以：
- 使用@TableField(fieldType = FieldType.KEYWORD_TEXT)注解，创建keyword+text双类型
- 冗余一个字段，一个标记为keyword类型，另一个标记为text类型
3. 实体类id字段问题
3.1 必须包含id字段
由于框架很多功能依赖id实现，实体类中必须包含id字段。
public class Document { /** * es中的唯一id,如果想自定义id,请将注解中的type指定为customize */ @TableId(type = IdType.CUSTOMIZE) private String id; }3.2 id字段的特殊行为
调用insert方法时，如果id已存在，会执行更新操作，这与Mybatis-Plus和MySQL的行为不同。
4. 与Mybatis-Plus共存问题
当项目中同时使用Mybatis-Plus和Easy-Es时，需要将两者的mapper放在不同目录，并分别配置扫描路径。
5. 查询API使用问题
5.1 eq查询无法获取结果
eq对应的是es的TermQuery()，需要被查询字段的索引类型为keyword。如果字段类型为text，应使用match()或queryString()等方式查询。
5.2 and和or的使用
ES的查询参数是树形数据结构，与MySQL不同，具体使用方法可参考官方文档。
6. 常见错误及解决方法
6.1 index_not_found_exception
检查索引名称是否正确配置，确认索引是否存在。可通过EE提供的API快速创建索引。
6.2 依赖冲突
如果发生依赖冲突，可通过移除重复依赖或统一依赖版本号来解决。EE可能发生冲突的依赖包括lombok、elasticsearch-rest-high-level-client等。
6.3 NoSuchMethod错误
通常是实体类中无id字段或高亮字段映射配置不正确导致。确保添加了id字段，并正确配置高亮映射。
7. 最佳实践建议
- 使用前仔细阅读官方文档，特别是避坑指南和常见问题
- 遇到问题先查看错误日志，尝试自己排查原因
- 合理设计索引结构，根据查询需求选择合适的字段类型
- 定期关注项目更新，及时了解新功能和bug修复
通过掌握这些常见问题及解决方案，相信您能更加顺畅地使用Easy-Es进行开发，避免不必要的踩坑，提高开发效率。如有其他问题，欢迎加入官方答疑群交流讨论。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
