知识条目 / Neo4j

Neo4j 堆内存溢出或查询变慢如何定位?

先区分堆内存不足与 page cache 不足,再定位大查询与事务;堆溢出需结合 GC 日志与查询日志判断。

Neo4j 对堆与 page cache 的职责划分明确:堆用于查询执行与事务状态,page cache 缓存图数据。配置不当会出现 GC 频繁或磁盘读放大。

处理步骤

  1. 确认内存配置检查 server.memory.heap.max_size 与 pagecache 配置,确认是否与机器内存匹配。
  2. 查看 GC 与日志分析 GC 日志中的停顿与老年代占用,查找 OutOfMemoryError 前后的大查询。
  3. 定位重查询通过查询日志与 dbms.listQueries 找到耗时高、返回量大的语句,优化遍历与索引。
  4. 调整与验证在容量评估后调整堆与 page cache,补充慢查询监控并复测。

示例

CALL dbms.listQueries()
YIELD query, elapsedTime, status
RETURN query, elapsedTime, status
ORDER BY elapsedTime DESC
LIMIT 20;

CALL dbms.queryJmx('java.lang:type=Memory')
YIELD attributes
RETURN attributes;

堆并非越大越好,过大会延长 GC 停顿;调整前需同时评估 page cache 与容器内存限制。

关键词

neo4j · oom · heap · page cache · gc · 慢查询 · 事务

官方文档

同库知识