PostgreSQL 15/16搭配AGE同查询计划下栈追踪差异问题

问题背景 #

在PostgreSQL 16与Apache AGE组合环境中，执行包含OPTIONAL MATCH的Cypher查询（该查询会被转换为LEFT-JOIN）时，PG16抛出错误：graph_oid and label_id must not be null，但相同操作在PostgreSQL 15中可正常执行。

对比两者的查询计划，结构基本一致，但在_label_name函数断点处的执行栈追踪存在明显差异：

• PG15的栈追踪包含ExecNestLoop调用ExecProcNode(innerPlan)的环节
• PG16的栈追踪中无此调用步骤

现需明确：为何相同查询计划下，PG15与PG16的执行栈会出现上述差异？

重现步骤 #

• 安装对应版本的PostgreSQL与Apache AGE
• 执行以下SQL脚本：

LOAD 'age';
SET search_path TO ag_catalog;

SELECT create_graph('cypher_match');

SELECT * FROM cypher('cypher_match', $$
    CREATE (:opt_match_v {name: 'someone'})-[:opt_match_e]->(:opt_match_v {name: 'somebody'}),
           (:opt_match_v {name: 'anybody'})-[:opt_match_e]->(:opt_match_v {name: 'nobody'})
$$) AS (u agtype);

SELECT * FROM cypher('cypher_match', $$
    MATCH (u:opt_match_v)
    OPTIONAL MATCH (u)-[m]-(l)
    RETURN u.name as u, type(m), l.name as l
$$) AS (u agtype, m agtype, l agtype);

核心原因分析 #

PostgreSQL 16在执行器的嵌套循环连接（NestLoop）逻辑上做了底层优化调整，直接导致了栈追踪的差异：

1. 空行处理逻辑变更：针对LEFT-JOIN中右表无匹配的场景，PG16跳过了对innerPlan的ExecProcNode调用，直接构造空结果行；而PG15仍会执行ExecProcNode(innerPlan)，即使最终返回空行。这是栈追踪差异的直接原因。
2. AGE适配遗漏：Apache AGE的_label_name函数依赖innerPlan执行过程中初始化的graph_oid和label_id参数，PG16跳过该步骤后，参数未被正确初始化，进而触发报错。
3. 查询计划的“逻辑等价”不等于“执行路径一致”：虽然查询计划的结构看起来相同，但PG16对执行路径做了精简优化，减少了不必要的节点调用，这是两者行为差异的本质原因。

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