Neo4j通过全文索引Cypher查询节点时报Lucene EOF错误如何解决

你遇到的Lucene解析异常本质是传入全文索引查询的关键词为空：

• 当你遍历所有:Email节点时，只要有任意节点的convEmail属性是空字符串/未设置/值为null，传入db.index.fulltext.queryNodes的第二个参数就为空，Lucene解析空查询语句就会触发<EOF>报错。
• 部分节点convEmail值全为空格、长度为0也会触发同样报错。

步骤1：过滤空值节点后执行查询 #

修改查询语句，先加筛选条件排除convEmail为空的节点即可解决报错：

MATCH (e: Email)
WHERE e.convEmail IS NOT NULL AND trim(e.convEmail) <> ''
WITH e
CALL db.index.fulltext.queryNodes('convEmailFtIndex', e.convEmail)
YIELD node, score
// 可选：过滤掉和当前节点完全一致的自身匹配结果
WHERE id(node) <> id(e)
RETURN e.email, node.convEmail, node.email, score 
ORDER BY e.email 
LIMIT 1000

步骤2：可选优化：规避特殊字符解析风险 #

如果后续需要兼容含特殊字符的查询场景，可以用APOC插件的apoc.text.escapeLucene函数对查询词做转义：

MATCH (e: Email)
WHERE e.convEmail IS NOT NULL AND trim(e.convEmail) <> ''
WITH e, apoc.text.escapeLucene(e.convEmail) AS queryStr
CALL db.index.fulltext.queryNodes('convEmailFtIndex', queryStr)
YIELD node, score
WHERE id(node) <> id(e)
RETURN e.email, node.convEmail, node.email, score 
ORDER BY e.email 
LIMIT 1000

步骤3：提前校验数据定位问题 #

可以先执行下面的语句统计空值节点数量，确认问题根因：

MATCH (e:Email)
WHERE e.convEmail IS NULL OR trim(e.convEmail) = ''
RETURN count(e) AS 空convEmail属性的节点数量

如果统计结果大于0，补充清洗这部分节点的convEmail属性即可彻底避免报错。

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