# 2201F — invalid_argument_for_power_function

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

# 2201F

## 速览 {#at-a-glance}
幂函数会拒绝实数结果未定义的操作数。固定 numeric 路径报告 `zero raised to a negative power is undefined` 或 `a negative number raised to a non-integer power yields a complex result`。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `2201F` |
| 条件名 | `invalid_argument_for_power_function` |
| 状态 | `有效` |
| 已知存在于 | `8.0.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_ARGUMENT_FOR_POWER_FUNCTION` |
| 别名 | `—` |

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

## 含义 {#meaning}
2201F 覆盖两个不同的幂运算守卫：零底数配负指数，以及负底数配非整数指数。普通有限 numeric 路径和特殊值路径都存在相应检查。按 POSIX 规则，numeric 的 NaN 可能返回 NaN 或 1，若干无穷组合也有定义结果；负底数配整数指数并不自动触发本码。

## 诊断 {#diagnosis}
检查解析后的底数、指数类型和首要报文。非整数小数指数与负整数指数不是同一种情况，改小数位数或无关 cast 不能修复定义域。特殊值要单独判断，不要把所有 NaN 或无穷值都当成无效幂运算。

## 处理 {#response}
选择具有预期实数结果的底数/指数，或明确改变业务规则。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交客户端可直接重试修正后的操作。

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

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

## 来源 {#sources}
有限值和特殊值守卫位于 [`src/backend/utils/adt/numeric.c#L4045-4111`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/numeric.c#L4045) 和 [`#L4208-4220`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/numeric.c#L4208)；负底数非整数守卫在 [`#L11373-11384`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/numeric.c#L11373)。结构化[证据记录](../../data/evidence/2201f.json)保留确切报文角色；本页未运行自然案例。