2201E

速览

对数函数会在定义域守卫处拒绝零值和负值。固定浮点路径报告 cannot take logarithm of zero 或 cannot take logarithm of a negative number；numeric 的 ln 和给定底数的对数路径也使用该 SQLSTATE，但会分别处理 NaN 与无穷值。

含义

2201E 是对数定义域错误，不是一般数值溢出。float.c 中 ln() 与 log() 先拒绝等于零的参数，再拒绝小于零的参数。numeric 的 ln 拒绝负无穷但原样返回 numeric NaN 或正无穷；numeric 的给定底数对数拒绝负值或零值输入，而某些正的特殊值组合有定义结果。

诊断

先读函数签名和实际数值类型，再定位参数。按首要报文区分零值守卫与负值守卫。浮点 NaN 不满足这两个比较，因此不会进入这条具体守卫；后续浮点溢出或下溢属于其他条件。检查对数定义域是否符合业务意图，不要只为转换而转换。

处理

提供符合目标对数函数定义域的值，或明确改变业务规则。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交客户端可直接重试修正后的语句。单纯 cast 不能使未定义运算变得有定义。

版本

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

相关

22003、22012

来源

固定路径包括 src/backend/utils/adt/float.c#L1687-1747 和 src/backend/utils/adt/numeric.c#L3935-4020 以及 #L11156-11168，绑定零值/负值守卫及特殊值分支。结构化证据记录保留确切报文角色和范围；本页未运行自然案例。