// PostgreSQL 错误参考

PostgreSQL 22003:数值超出范围

一个数字不适合其类型:整数溢出、numeric(p,s) 值过大,或 id 列达到 int4 上限。

SQLSTATE
22003
名称
numeric_value_out_of_range
类别
数据异常
错误信息
integer out of range

它的意思

每种数值类型都有其取值范围: smallint 最多 32767, integer 最多 32,767, bigint 最多约 9.2 × 10^18,且 numeric(p, s) 最多 p 位数字,小数点后有 s 位。值或计算结果超出范围会导致 22003 错误。该消息会指明类型: integer out of range, bigint out of range, smallint out of range,或 numeric field overflow 用于 numeric(p, s).

两个整数的算术运算在整数中进行,因此 count * price_in_cents 可能溢出,即使最终答案存储在 bigint 列。

常见原因

  • A serial (整数) 主键达到了 2147483647,于是 nextval 生成了列无法存储的值。
  • 对整数做乘法或求和时,结果在类型转换之前就超出了整数范围。
  • 值的位数超过了 numeric(p, s) 允许,例如 1000.00 出现在 numeric(5,2) 列。
  • 将大型文本或浮点值强制转换为 integer 或者 smallint.

如何修复它

  1. 加宽该列;对于快要用尽的整型 id,则换成 bigint (这会重写表,因此需提前计划)。

    ALTER TABLE events ALTER COLUMN id TYPE bigint;
    ALTER SEQUENCE events_id_seq AS bigint;
  2. 在算术操作前先强制转换为更宽的类型,而不是操作后。

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. 增加精度 numeric(p, s) 列。

    ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
  4. 检查序列距离其上限还有多远。

    SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';

安全地复现它

SELECT 2147483647 + 1;      -- ERROR: integer out of range
SELECT 1000::numeric(5, 2);  -- ERROR: numeric field overflow

相关错误

更多数据异常错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。