【图数据库内核】Page cache 与指针追逐：布局如何变成命中率
内容提要
本文介绍Neo4j图数据库的page cache机制：页大小为8192字节，用于缓存磁盘上的图数据和原生索引。配置上建议显式设置server.memory.pagecache.size，并通过hit_ratio（应达98%以上）、usage_ratio、page_faults等指标监控健康度。Record格式易受随机指针颠簸影响，Block格式通过数据共置减少页访问，超节点则需建模优化。扩缓存只是优化手段之一。
延伸解读
布局如何影响缓存命中率
文章指出，图数据的物理布局直接决定了page cache的命中率。Record格式下，关系链的next指针可能随机跳跃，导致每次跳转都可能触发一次page fault；而Block格式通过将相关数据共置在同一页，减少了每次hop所需的页数。因此，在评估图数据库性能时，不仅要看缓存大小，还要考虑数据布局的局部性。
监控指标的正确解读
hit_ratio应稳定在98%以上，但全局高命中率不代表单条查询不慢，因为可能访问冷区或超节点。page_faults持续上升可能表示缓存不足，但需排除启动warmup和批量导入的影响。usage_ratio达到100%时，命中率可能下降，此时考虑增加缓存。同时，要警惕堆内存不足导致的伪I/O问题，此时命中率虽高但查询仍慢。
缓存配置的实用建议
建议显式设置server.memory.pagecache.size，避免依赖启动时的启发式估算。可使用memory-recommendation命令获取推荐值，并参考data + native indexes的总量。但容量规划只是启发式，实际工作集可能远小于全库，超节点和全图扫描会逼近全库大小。同时，注意heap、page cache、Lucene和OS内存的分配，避免内存争抢。
Q&A
Neo4j的page cache默认页大小是多少？
Neo4j的page cache默认页大小是8192字节（8KB），由PageCache.PAGE_SIZE常量定义。
如何配置Neo4j的page cache大小？
在neo4j.conf中显式设置server.memory.pagecache.size，例如：server.memory.pagecache.size=42GB。建议同时显式设置堆大小，并使用bin/neo4j-admin server memory-recommendation命令获取推荐值。
Neo4j page cache的hit_ratio指标正常范围是多少？
hit_ratio应稳定在98%–100%，如果明显低于98%则说明频繁读盘，可能需要调整缓存或查询。
Record格式和Block格式在page cache命中率上有什么区别？
Record格式的指针链容易跨页跳跃，导致随机指针颠簸，增加page fault；Block格式通过数据共置减少每次hop的页访问，降低fault机会，但会增大store体积。
超节点对page cache有什么影响？
超节点（度数极高的节点）会导致工作集变成一棵树的热路径加大叶集，即使全局hit_ratio正常，单查询延迟也可能因pins尖峰而变差。扩缓存直到塞进该点的全部边页之前，收益是阶梯状的。
page cache和OS page cache有什么关系？
Neo4j page cache是进程内受管缓存，OS也可能缓存文件页。两者共享物理内存，配置时需考虑heap、page cache、Lucene/向量索引和OS的总和不超过物理内存，并建议关闭swap。
page_cache.usage_ratio达到100%意味着什么？
usage_ratio达到100%表示所有可用页都已使用，此时hit_ratio容易下降，通常意味着需要增加page cache大小。
为什么只扩大page cache不能解决所有性能问题？
因为性能问题可能源于堆内存不足（如中间结果爆炸）、向量/Lucene路径或查询计划问题，这些不是page cache能解决的。需要综合调整堆、查询和建模。
