Neo4j启动失败排查请求：EC2环境导入大数据后无法运行

背景 #

我的Neo4j 5.15社区版部署在EC2上，此前运行正常，上周更新到Java 17.0.9后也未出现异常。今日导入小量数据操作正常，但导入约1.5G全量数据后进程崩溃，Neo4j彻底无法访问。卸载重装同版本及最新版本均无法解决问题。

报错信息 #

JIT compiler: HotSpot 64-Bit Tiered Compilers
VM Arguments: [-Xmx128m, -Dapp.name=neo4j, -Dapp.pid=8597, -Dapp.repo=/usr/share/neo4j/repo, -Dapp.home=/usr/share/neo4j, -Dbasedir=/usr/share/neo4j]
Configuration files used (ordered by priority):
/etc/neo4j/neo4j.conf
--------------------
org.neo4j.cli.CommandFailedException: Neo4j is not running.
    at org.neo4j.server.startup.Bootloader$Dbms.status(Bootloader.java:529)
    at org.neo4j.server.startup.StatusCommand.execute(StatusCommand.java:37)
    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.server.startup.Neo4jAdminCommand.call(Neo4jAdminCommand.java:123)
    at org.neo4j.server.startup.Neo4jAdminCommand.call(Neo4jAdminCommand.java:42)
    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.server.startup.Neo4jCommand.main(Neo4jCommand.java:41)
    at org.neo4j.server.startup.Neo4jBoot.main(Neo4jBoot.java:30)

排查方向与解决方法 #

注意：你贴的报错只是查询状态时返回的“Neo4j未运行”，这是崩溃后的结果，而非根本原因。需要结合核心日志（neo4j.log、debug.log或EC2系统日志）定位问题，以下是常见可能性：

• 内存配置严重不足
  从VM参数能看到-Xmx128m，这个堆内存大小连小数据导入都勉强，1.5G数据导入必然触发OOM崩溃。
  解决：修改/etc/neo4j/neo4j.conf：

  • 调整dbms.memory.heap.max_size为EC2实例内存的50%（比如4G内存的实例设为2G）
  • 调整dbms.memory.pagecache.size为剩余内存的70%左右
    保存后重启Neo4j。

• 磁盘空间耗尽
  导入大数据时磁盘占满，导致进程强制崩溃。
  排查：执行df -h查看磁盘使用率，重点看Neo4j数据目录（默认/var/lib/neo4j/data）所在分区。
  解决：扩容EC2的EBS卷，或清理分区内的无用文件释放空间。

• 数据库文件损坏
  导入中途崩溃可能导致数据文件损坏，重装时如果未清理旧数据目录，问题会持续存在。
  解决：

  1. 停止Neo4j服务：systemctl stop neo4j
  2. 备份旧数据目录：cp -r /var/lib/neo4j/data /var/lib/neo4j/data_backup
  3. 删除损坏的数据文件：rm -rf /var/lib/neo4j/data/databases /var/lib/neo4j/data/transactions
  4. 重启Neo4j，之后重新导入数据。

• Java版本兼容性问题
  虽然小数据导入正常，但大导入时的JIT编译或内存管理可能触发了Java 17.0.9的特定bug。
  解决：临时降级到之前正常的Java版本，或升级到Java 17的更高小版本（如17.0.10及以上）后再尝试启动。

• EC2系统层面OOM Killer触发
  导入大数据时CPU、内存或磁盘IO过载，EC2的OOM Killer进程直接终止了Neo4j。
  排查：查看EC2系统日志（AWS控制台实例日志或执行dmesg命令），如果有Out of memory: Killed process neo4j相关记录，说明是系统内存不足。
  解决：升级EC2实例规格，或调整Neo4j内存配置避免占用过多系统资源。

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