54001

速览 {#at-a-glance}

54001 覆盖超过规划器、解析器或执行栈限制的语句。固定路径包括 4096 个 grouping set 上限和 max_stack_depth 检查。

含义 {#meaning}

源码区分结构性查询上限 too many grouping sets present (maximum 4096) 与递归执行深度 stack depth limit exceeded，后者 hint 指向 max_stack_depth。两者修复不同。

诊断 {#diagnosis}

保留消息和阶段：grouping sets 应统计生成数量并简化查询；stack depth 应检查递归 SQL/函数展开，并在改设置前比较平台栈限制。

处理 {#response}

重写或拆分结构过大的语句；stack depth 应先消除意外递归或减少嵌套，仅在确认操作系统栈允许时调整 max_stack_depth，再验证重写后的语句。显式事务中若发生此 ERROR，重试前执行 ROLLBACK 或 ROLLBACK TO SAVEPOINT；自动提交只有在语句或 stack setting 修正后才能重试。GUC 的 rlimit 检查会在 SET 或配置值校验时比较平台栈上限；若 SET 失败，仍按发起它的事务上下文恢复。

版本 {#versions}

锁定目录从 7.4 记录；引用解析器和栈深度路径来自 PostgreSQL 18.6，未强制触发限制。

相关 {#related}

54000、54011、42601

来源 {#sources}

src/backend/parser/parse_agg.c#L1166-L1172

src/backend/utils/misc/stack_depth.c#L100-L105

src/backend/utils/misc/stack_depth.c#L156-L168

结构化证据记录保存固定消息以及源码/运行边界。

来源

• 上游源码 src/backend/utils/errcodes.txt 第 417 行 REL_18_6 724edf9bd 6e8de346
• 上游源码 src/backend/parser/parse_agg.c 第 1166 行 REL_18_6 724edf9bd 6e80a805
• 上游源码 src/backend/utils/misc/stack_depth.c 第 100 行 REL_18_6 724edf9bd ed87e94a
• 上游源码 src/backend/utils/misc/stack_depth.c 第 156 行 REL_18_6 724edf9bd ed87e94a