# 09000 — triggered_action_exception

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

# 09000

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

SQLSTATE 09000 是 ERROR 级别的触发动作条件。在固定的 PostgreSQL 18.6 扫描中，已确认的报告路径位于 `contrib/spi` 触发器函数：它们检查触发器参数、目标列类型、被引用元组以及 SPI 返回码。因此该代码与这些已安装的触发器函数及其表/触发器配置有关，不能把它当成所有触发器失败的统称。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `09000` |
| 条件名 | `triggered_action_exception` |
| 状态 | `有效` |
| 已知存在于 | `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_TRIGGERED_ACTION_EXCEPTION` |
| 别名 | `—` |

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

## 含义 {#meaning}

已确认的路径包括 `autoinc.c`、`insert_username.c`、`moddatetime.c` 和 `refint.c`。消息变体包括 `"%s" has no attribute "%s"`、`attribute "%s" of "%s" must be type INT4`、`... TEXT` 以及 `... TIMESTAMP or TIMESTAMPTZ`。参照完整性路径还会报告 `tuple references non-existent key`，并带有 `Trigger "%s" found tuple referencing non-existent key in "%s".` detail；SPI 失败可报告 `SPI_execp returned %d`，`RESTRICT` 动作还可报告 `"%s": tuple is referenced in "%s"`。这些模板中的关系、参数、属性、触发器和返回码来自具体失败路径。

## 消息 {#messages}

固定变体包括 `"%s" has no attribute "%s"`、`attribute "%s" of "%s" must be type INT4`、`TEXT` 或 `TIMESTAMP or TIMESTAMPTZ`。参照完整性路径还会报告 `tuple references non-existent key`，并带有 `Trigger "%s" found tuple referencing non-existent key in "%s".` detail；SPI 失败可报告 `SPI_execp returned %d`，`RESTRICT` 动作还可报告 `"%s": tuple is referenced in "%s"`。这些模板中的关系、参数、属性、触发器和返回码来自具体失败路径。

## 诊断 {#diagnosis}

先确认已安装的触发器函数和操作阶段，再把关系及触发器参数与该函数的文档契约对照。出现属性/类型消息时检查所点名的列及其类型；出现 `refint` 变体时检查触发器名、被引用关系以及元组或键的关系。出现 `SPI_execp returned %d` 时保留返回码，并检查返回该码的 SPI 调用。固定扫描没有证明所有 09000 报告都使用同一条消息。

## 处理 {#response}

根据消息修正触发器定义、参数列表、列类型、被引用键或 SPI 侧失败原因，确认修改后再执行触发操作。不要盲目重放写入来修复它：触发器可能已经在报错前完成部分工作，正确恢复边界取决于外层事务。若函数来自扩展或本地代码，应先检查该实现及其版本，再决定应用层的重试行为。

## 版本 {#versions}

锁定目录将该条件的已知下界记为 PostgreSQL 7.4。事实块列出已发布快照；源码路径状态仅限于下方固定的 PostgreSQL 18.6 资料。

## 相关 {#related}

[`0A000`](../0a000/), [`2F000`](../2f000/)

## 来源 {#sources}

[autoinc.c](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/contrib/spi/autoinc.c#L74-L90)、[insert_username.c](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/contrib/spi/insert_username.c#L74-L82)、[moddatetime.c](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/contrib/spi/moddatetime.c#L95-L120) 和 [refint.c](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/contrib/spi/refint.c#L181-L184) 及其[参照限制分支](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/contrib/spi/refint.c#L504-L516)展示固定的报告路径；[SPI 触发器文档](https://www.postgresql.org/docs/18/spi.html)说明扩展接口。 详见结构化[证据记录](../../data/evidence/09000.json)，其中记录固定源码路径、扫描范围和未解决的运行边界。