# 2201X — invalid_row_count_in_result_offset_clause

> PostgreSQL SQLSTATE 2201X 的来源与诊断参考。
---

# 2201X

## 速览 {#at-a-glance}
OFFSET 表达式求值后为负数。固定执行器路径报告 `OFFSET must not be negative`。

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `2201X` |
| 条件名 | `invalid_row_count_in_result_offset_clause` |
| 状态 | `有效` |
| 已知存在于 | `8.4.0` |
| 锁定快照 | `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_INVALID_ROW_COUNT_IN_RESULT_OFFSET_CLAUSE` |
| 别名 | `—` |

<!-- source facts: data/errcodes/2201X.json -->
<!-- END SQLSTATE FACTS -->

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

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

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

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

## 相关 {#related}
[`2201W`](../2201w/)、[`22003`](../22003/)

## 来源 {#sources}
执行器将 NULL 转为零并检查负值的守卫在 [`src/backend/executor/nodeLimit.c#L356-375`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/executor/nodeLimit.c#L356)。结构化[证据记录](../../data/evidence/2201x.json)保留确切首要模板和源码边界；本页未运行自然案例。