如何解决Neo4j中“Index has a leaked page”索引不一致错误？

问题背景 #

对Neo4j 5.8.0生成的dump文件执行一致性检查：

sudo neo4j-admin database check --from-path=./ neo4j

报告出现索引泄露页错误：

ERROR Index inconsistency: Index has a leaked page that will never be reclaimed, pageId=208.
Index will be excluded from further consistency checks. Index file: /data1/dumps2/4459558985020293571/neo4j/schema/index/range-1.0/75/index-75.

ERROR Index inconsistency: Index has a leaked page that will never be reclaimed, pageId=247.
Index will be excluded from further consistency checks. Index file: /data1/dumps2/4459558985020293571/neo4j/schema/index/range-1.0/75/index-75.

需要修复后将dump上传至Neo4j AuraDB。

解决方案 #

这类索引底层存储的泄露页问题修复成本极高，最高效可靠的方案是排除索引重新生成dump，在目标AuraDB中重建索引，步骤如下：

1. 生成排除索引的干净Dump文件 #

在原Neo4j 5.8.0实例上执行导出命令，跳过所有索引：

sudo neo4j-admin database dump --exclude-indexes neo4j --to-path=./clean-dump

此命令会生成不包含任何索引数据的dump文件，避免携带索引的一致性问题。

2. 验证干净Dump的一致性 #

对新生成的dump执行一致性检查，确认无错误：

sudo neo4j-admin database check --from-path=./clean-dump neo4j

3. 将干净Dump导入AuraDB #

使用Neo4j官方工具导入到AuraDB，替换占位符为你的Aura实例信息：

neo4j-admin database import aura --from-dump=./clean-dump/neo4j.dump --to-aura-uri=<你的AuraDB URI> --username=<用户名> --password=<密码>

也可以通过Aura控制台的导入功能完成此操作。

4. 在AuraDB中重建索引 #

• 先在原Neo4j 5.8.0实例中导出所有索引定义：

  CALL db.indexes() YIELD name, type, labelsOrTypes, properties
  RETURN name, type, labelsOrTypes, properties
  

  记录每个索引的类型、关联标签/类型、属性等信息。
• 在AuraDB中执行对应的Cypher语句重建索引，例如：
  • 范围索引：CREATE INDEX FOR (n:Label) ON (n.property)
  • 全文索引：CREATE FULLTEXT INDEX index_name FOR (n:Label) ON EACH [n.prop1, n.prop2]

说明 #

索引属于可重建的元数据，放弃修复原dump中的索引问题，转而在目标库重建，既节省时间，又能保证索引在AuraDB中处于完全健康的状态，完美适配迁移到Aura的场景。

内容的提问来源于stack exchange，提问作者David Betancourt M.