# P0003 — too_many_rows

> PostgreSQL SQLSTATE P0003 的源码与诊断参考。
---

# P0003

## 速览 {#at-a-glance}

P0003 是 PL/pgSQL `too_many_rows`。固定路径给出准确的 message、可选 detail、hint 和按实际分支决定的严重级别。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `P0003` |
| 条件名 | `too_many_rows` |
| 状态 | `有效` |
| 已知存在于 | `8.2.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_TOO_MANY_ROWS` |
| 别名 | `—` |

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

## 含义 {#meaning}

当受检查的 PL/pgSQL 查询返回多于一行时，源码报告 `query returned more than one row`；开启 strict 参数打印时可附带 `parameters: %s`，并在一条路径提供 `Make sure the query returns a single row, or use LIMIT 1.` hint。普通多行 SELECT 不会因此自动成为 P0003。

## 诊断 {#diagnosis}

先看是否是严格目标赋值或 modifying statement，再检查完整 detail/hint。固定源码先按 `plpgsql.extra_errors`/`plpgsql.extra_warnings` 对 `too_many_rows` 的选择设置级别：前者优先并使用 ERROR，只有后者生效时才使用 WARNING；strict/modifying 路径无论这些设置如何都使用 ERROR，所以不要只凭条件名断言严重级别。

## 处置 {#response}

让查询满足单行契约，或改用能表达多行结果的 PL/pgSQL 结构；若业务允许第一行，必须显式设计排序和截取语义，而不是盲目套用 hint。修正查询契约后再执行，避免把同一多行结果自动重放成重复业务操作。

## 版本 {#versions}

锁定目录从 8.2.0 记录该条件，并在列出的正式快照及 19beta3 中出现；运行时未在本批次重演。

## 相关条件 {#related}

[`P0002`](../p0002/), [`P0004`](../p0004/), [`02000`](../02000/)

## 来源 {#sources}

可直接阅读固定的 [pl_exec.c](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/pl/plpgsql/src/pl_exec.c#L4215-L4220) GUC 分支和[报告路径](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/pl/plpgsql/src/pl_exec.c#L4394-L4410)；完整范围见结构化[证据记录](../../data/evidence/p0003.json)。