54001: statement_too_complex

含义

语句的复杂度超出 PostgreSQL 的处理能力；通常是嵌套极深的表达式或大量嵌套运算符使表达式树超过解析器/规划器的栈限制。属于 Class 54（program_limit_exceeded）。

原因

过深的括号/嵌套子查询或 OR/AND 链；自动生成的巨大 WHERE ... IN (...) 列表；或递归视图产生的超大表达式树。达到了 max_stack_depth 限制。

解决方法

简化查询：将长 IN 列表放入临时表或 VALUES 集合并与之 JOIN；拆分嵌套表达式；审查 ORM 生成的巨型查询。如确有必要且操作系统栈限制允许，谨慎调高 max_stack_depth（例如 SET max_stack_depth = '4MB';），但要保持低于操作系统 ulimit。