运行Lucene官方Demo时查询结果不符合预期是什么原因？

• 第一步：验证SearchFiles.java内容匹配性
  手动打开SearchFiles.java文件，确认文件内是否同时存在lucene和main两个字符串。官方Demo默认使用StandardAnalyzer构建索引，会自动将所有分词转为小写，若文件中存在的是大写开头的Lucene也会被处理为小写lucene，不影响匹配。如果文件内确实缺少任一关键词，返回结果自然不会包含该文件。
• 第二步：确认文件是否被正常索引
  查看IndexFiles执行时的控制台输出，确认输出列表中存在SearchFiles.java的索引成功记录。如果没有该记录，需检查文件是否被IndexFiles的默认过滤规则排除（比如文件无读取权限、属于隐藏文件/目录、后缀不在默认允许索引的列表内）。
• 第三步：校验索引与搜索路径一致性
  确认执行SearchFiles时传入的-index .路径，和执行IndexFiles时的-index .路径完全一致，避免搜索的是旧版本的无效索引。可以尝试将查询语句替换为-query "*:*"返回所有索引文档，查看结果中是否存在SearchFiles.java：
  • 如果存在，说明是查询条件匹配问题，继续下一步排查
  • 如果不存在，说明该文件确实未被索引，回到第二步调整索引规则
• 第四步：检查索引内容截断问题
  官方Demo的IndexFiles默认对单文件索引内容有长度上限，如果SearchFiles.java的文件大小超过上限，后半部分内容会被截断无法索引。如果lucene或main关键词刚好位于被截断的内容段，就会出现匹配失败的情况。可以修改IndexFiles源码中的内容读取长度限制，重新构建索引后再搜索验证。
• 第五步：验证分词结果
  可以编写简单的测试代码，遍历当前索引中SearchFiles.java对应的文档，打印contents字段的所有分词结果，确认是否同时存在lucene和main两个分词项，定位是索引阶段分词异常还是搜索阶段query解析异常。

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