Docker环境下Neo4j 4.3升级至5.x加载备份dump失败求助

问题场景 #

在Docker环境中将Neo4j从4.3版本升级至5.x，执行加载备份dump的命令时失败，抛出Can not read store version of database neo4j异常。

执行命令 #

/var/lib/neo4j/bin# neo4j-admin database load --from-path=/backups  neo4j --overwrite-destination --verbose

错误日志 #

Executing command line: /opt/java/openjdk/bin/java -cp /var/lib/neo4j/plugins/*:/var/lib/neo4j/conf/*:/var/lib/neo4j/lib/* -XX:+UseParallelGC -XX:-OmitStackTraceInFastThrow -XX:+UnlockExperimentalVMOptions -XX:+TrustFinalNonStaticFields -XX:+DisableExplicitGC -Djdk.nio.maxCachedBufferSize=1024 -Dio.netty.tryReflectionSetAccessible=true -XX:+ExitOnOutOfMemoryError -Djdk.tls.ephemeralDHKeySize=2048 -XX:FlightRecorderOptions=stackdepth=256 -XX:+UnlockDiagnosticVMOptions -XX:+DebugNonSafepoints --add-opens=java.base/java.nio=ALL-UNNAMED --add-opens=java.base/java.io=ALL-UNNAMED --add-opens=java.base/sun.nio.ch=ALL-UNNAMED -Dlog4j2.disable.jmx=true -Dfile.encoding=UTF-8 -Xmx2097152k org.neo4j.cli.AdminTool database load --from-path=/backups neo4j --overwrite-destination --verbose
neo4j 5.5.0
VM Name: OpenJDK 64-Bit Server VM
VM Vendor: Eclipse Adoptium
VM Version: 17.0.6+10
JIT compiler: HotSpot 64-Bit Tiered Compilers
VM Arguments: [-XX:+UseParallelGC, -XX:-OmitStackTraceInFastThrow, -XX:+UnlockExperimentalVMOptions, -XX:+TrustFinalNonStaticFields, -XX:+DisableExplicitGC, -Djdk.nio.maxCachedBufferSize=1024, -Dio.netty.tryReflectionSetAccessible=true, -XX:+ExitOnOutOfMemoryError, -Djdk.tls.ephemeralDHKeySize=2048, -XX:FlightRecorderOptions=stackdepth=256, -XX:+UnlockDiagnosticVMOptions, -XX:+DebugNonSafepoints, --add-opens=java.base/java.nio=ALL-UNNAMED, --add-opens=java.base/java.io=ALL-UNNAMED, --add-opens=java.base/sun.nio.ch=ALL-UNNAMED, -Dlog4j2.disable.jmx=true, -Dfile.encoding=UTF-8, -Xmx2097152k]
Configuration files used (ordered by priority):
/var/lib/neo4j/conf/neo4j-admin.conf
/var/lib/neo4j/conf/neo4j.conf
--------------------
Done: 53 files, 251.4MiB processed.
Failed to load database 'neo4j': Can not read store version of database neo4jLoad failed for databases: 'neo4j'
org.neo4j.cli.CommandFailedException: Load failed for databases: 'neo4j'
        at org.neo4j.commandline.dbms.LoadCommand.checkFailure(LoadCommand.java:219)
        at org.neo4j.commandline.dbms.LoadCommand.loadDump(LoadCommand.java:207)
        at org.neo4j.commandline.dbms.LoadCommand.execute(LoadCommand.java:150)
        at org.neo4j.cli.AbstractCommand.call(AbstractCommand.java:92)
        at org.neo4j.cli.AbstractCommand.call(AbstractCommand.java:37)
        at picocli.CommandLine.executeUserObject(CommandLine.java:2041)
        at picocli.CommandLine.access$1500(CommandLine.java:148)
        at picocli.CommandLine$RunLast.executeUserObjectOfLastSubcommandWithSameParent(CommandLine.java:2461)
        at picocli.CommandLine$RunLast.handle(CommandLine.java:2453)
        at picocli.CommandLine$RunLast.handle(CommandLine.java:2415)
        at picocli.CommandLine$AbstractParseResultHandler.execute(CommandLine.java:2273)
        at picocli.CommandLine$RunLast.execute(CommandLine.java:2417)
        at picocli.CommandLine.execute(CommandLine.java:2170)
        at org.neo4j.cli.AdminTool.execute(AdminTool.java:94)
        at org.neo4j.cli.AdminTool.main(AdminTool.java:82)
Caused by: java.lang.IllegalStateException: Can not read store version of database neo4j
        at org.neo4j.commandline.dbms.StoreVersionLoader.loadStoreVersion(StoreVersionLoader.java:88)
        at org.neo4j.dbms.archive.Loader.getStoreVersion(Loader.java:131)
        at org.neo4j.commandline.dbms.LoadDumpExecutor.execute(LoadDumpExecutor.java:84)
        at org.neo4j.commandline.dbms.LoadCommand.loadDump(LoadCommand.java:197)
        ... 13 more

解决方案 #

这个错误的核心原因是Neo4j 5.x无法直接读取4.3版本的存储格式，需按以下步骤处理：

1. 遵循官方逐步升级路径 #

跨大版本升级必须经过中间过渡版本，正确路径为：

• 先将4.3版本升级至同大版本的最新版4.4
• 再从4.4版本升级至目标5.x版本

2. 备份迁移的正确流程 #

如果使用dump备份迁移：

• 在4.3版本的Neo4j实例中执行neo4j-admin dump生成合法备份文件
• 启动Neo4j 4.4版本容器，挂载备份目录，执行neo4j-admin load加载备份，完成存储格式到4.4的升级
• 将4.4版本的数据库目录复制到5.x环境，停止5.x服务后执行neo4j-admin database upgrade完成最终格式升级

3. Docker环境操作注意事项 #

• 每个升级阶段使用对应版本的Neo4j容器，确保数据卷/备份目录挂载正确
• 执行任何升级或加载命令前，必须停止当前运行的Neo4j服务，避免数据冲突
• 验证备份文件完整性，确认dump文件来自正常运行的4.3实例

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