54023 — too_many_arguments

PostgreSQL SQLSTATE 54023 的来源与诊断参考。

54023

速览

54023 是函数、过程、聚合和返回集合调用的参数数量上限。固定路径保护 catalog 数组、parser 节点和 executor FunctionCallInfo 存储，并按单复数报告编译时实际限制。

字段	值
SQLSTATE	`54023`
条件名	`too_many_arguments`
状态	`有效`
已知存在于	`7.4`
锁定快照	`9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3`
宏	`ERRCODE_TOO_MANY_ARGUMENTS`
别名	`—`

含义

固定构建在 pg_config_manual.h 中把 FUNC_MAX_ARGS 定义为 100；源码说明实际可行上限约为 600，修改它需要完整重编 backend（包括 C 函数）。函数定义统计输入参数，明确不统计 output 参数。聚合定义和聚合调用使用 FUNC_MAX_ARGS - 1，为 transition/final function 保留可表示空间。函数/过程 parser 与 executor guard 还覆盖显式参数、默认参数、SRF 和保存的 window expression。调用者和对象类型决定修复。

报文

源码路径	精确 primary 模板（单数 / 复数）	`%d` 的计数上限
`pg_proc.c` 函数定义	`functions cannot have more than %d argument` / `functions cannot have more than %d arguments`	将 `parameterCount`（input 参数数组长度，不含 output 参数）与 `FUNC_MAX_ARGS` 比较；`%d` 传入 `FUNC_MAX_ARGS`（100）
`functioncmds.c` 过程调用	`cannot pass more than %d argument to a procedure` / `cannot pass more than %d arguments to a procedure`	将 `nargs = list_length(fexpr->args)` 与 `FUNC_MAX_ARGS` 比较；`%d` 传入 `FUNC_MAX_ARGS`
`parse_func.c`、`execExpr.c`、`execSRF.c`、`nodeWindowAgg.c` 函数/SRF/window 调用	`cannot pass more than %d argument to a function` / `cannot pass more than %d arguments to a function`	将 `list_length(fargs)`、`nargs`、`list_length(sexpr->args)` 或 `perfuncstate->numArguments` 与 `FUNC_MAX_ARGS` 比较；`%d` 传入 `FUNC_MAX_ARGS`
`pg_aggregate.c` 聚合定义/调用	`aggregates cannot have more than %d argument` / `aggregates cannot have more than %d arguments`	将 `numArgs` 与 `FUNC_MAX_ARGS - 1` 比较；`%d` 传入 99，为 transition/final function 预留槽位

这些是 errmsg_plural 分组，客户端应保留服务器的单复数渲染和实际上限，不要只搜索一条手写字符串。

诊断

先确认是在 CREATE/定义阶段还是调用阶段，以及对象是函数、过程、聚合、SRF 还是 window aggregate。统计显式参数和 parser 展开的默认参数；聚合使用更严格的 FUNC_MAX_ARGS - 1 边界。保留消息的单复数 primary 与上限，并检查 stored view/plan 是否由不同 FUNC_MAX_ARGS 的二进制建立。

处理

减少参数，把相关值组合为复合/record 类型，或重设计函数边界。修改过程或聚合签名时同步依赖调用者；不要静默丢弃参数、把 output 参数当 input 计数，也不要假设聚合和普通函数共用同一上限。修改 FUNC_MAX_ARGS 是构建级兼容决策，不是会话参数。显式事务中若发生 ERROR，重试前执行 ROLLBACK 或 ROLLBACK TO SAVEPOINT；自动提交只有在定义或调用已改到固定计数以内后才能重试。