2201X

速览

OFFSET 表达式求值后为负数。固定执行器路径报告 OFFSET must not be negative。

含义

LIMIT 节点重算时，NULL OFFSET 被解释为零（无偏移），零值合法，只有求得负值才进入 2201X。这是 2201W 的 OFFSET 专属姊妹码；LIMIT 或 FETCH 行数错误应按自己的 SQLSTATE 诊断。

诊断

在参数替换和类型解析后检查 OFFSET 的实际值。区分 NULL/无偏移、零值和负值，不要把 LIMIT 或 FETCH 行数失败改称 2201X。

处理

提供非负 OFFSET；若目标是无偏移，也可使用 NULL。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交可重试修正后的语句。

版本

锁定目录从 8.4.0 起记录该条件；本页固定源码路径为 PostgreSQL 18.6。未声称本页有自然运行观察。

相关

2201W、22003

来源

执行器将 NULL 转为零并检查负值的守卫在 src/backend/executor/nodeLimit.c#L356-375。结构化证据记录保留确切首要模板和源码边界；本页未运行自然案例。