知识条目 / Neo4j

Neo4j Cypher 查询慢如何优化?

用 PROFILE 查看算子与基数,补齐索引与约束,避免从低选择性节点开始遍历和笛卡尔积。

Cypher 的执行代价取决于起点选择与关系遍历规模。缺少索引会让查询从全量节点扫描开始,后续再好的图结构也无法挽回性能。

处理步骤

  1. 用 PROFILE 定位算子对比 PROFILE 中每个算子的输出行数与数据库命中数,找出基数爆炸或重复扫描的位置,而不是只看总耗时。
  2. 补齐索引与约束为常用起点属性建立索引,并为唯一标识建立唯一约束。MATCH 中的属性过滤只有在有索引时才能快速定位起点。
  3. 优化遍历方向与范围尽量从高选择性节点出发,限制可变长度路径的深度。避免无约束的笛卡尔积与全图扫描。
  4. 关注内存与缓存大范围遍历会占用大量堆内存,Eager 算子可能导致中间结果膨胀。增加页缓存并拆分复杂查询有助于稳定延迟。

示例

CREATE CONSTRAINT user_id_unique
IF NOT EXISTS
FOR (u:User) REQUIRE u.id IS UNIQUE;

CREATE INDEX order_no_index
IF NOT EXISTS
FOR (o:Order) ON (o.orderNo);

PROFILE
MATCH (u:User { id: $userId })-[:PLACED]->(o:Order)
WHERE o.createdAt >= date("2026-11-01")
RETURN o.orderNo, o.amount
ORDER BY o.createdAt DESC
LIMIT 20;

PROFILE 会真实执行查询,生产环境先用 EXPLAIN 评估。大范围遍历请限制深度并设置超时。

关键词

neo4j · 图数据库 · cypher · profile · explain · 索引 · 约束 · 基数 · 遍历 · eager

同库知识