如何解决org.neo4j.internal.unsafe.NativeMemoryAllocationRefusedError错误？

算力阿峰

2026-7-10

处理3000份文档构建Neo4j图时NativeMemoryAllocationRefusedError的解决方法

错误原因分析

你遇到的NativeMemoryAllocationRefusedError不是Java堆内存不足（你已经调整了-Xmx4096m），而是Neo4j的堆外内存（页缓存）分配失败。Neo4j的页缓存用于存储数据页，默认使用堆外内存，和JVM堆内存是独立的。从错误日志来看，系统仍有空闲物理内存，但页缓存的可用配额已耗尽。

具体解决步骤

1. 调整Neo4j页缓存大小

Neo4j默认页缓存为物理内存的50%，但嵌入式模式下需要手动配置：

若使用嵌入式Neo4j，初始化数据库时设置页缓存参数：

GraphDatabaseService db = new GraphDatabaseFactory()
    .newEmbeddedDatabaseBuilder(new File("你的数据库路径"))
    .setConfig(GraphDatabaseSettings.pagecache_memory, "8g") // 结合你的16G物理内存，建议设置为8G
    .newGraphDatabase();

若使用独立服务器模式，修改neo4j.conf文件中的dbms.memory.pagecache.size，例如设置为8g。

2. 放开JVM堆外内存限制

检查JVM启动参数是否设置了-XX:MaxDirectMemorySize，如果值过小会限制堆外内存分配：

直接移除该参数（让JVM自动管理），或者设置足够大的值：
```
-XX:MaxDirectMemorySize=10g
```

3. 优化数据导入逻辑

批量提交事务：不要每条数据单独提交，每处理100-500份文档后批量提交一次，降低内存压力：

try (Transaction tx = db.beginTx()) {
    // 处理文档的业务逻辑
    if (count % 100 == 0) {
        tx.commit();
        tx.close();
        tx = db.beginTx();
    }
    tx.commit();
}