// MySQL 错误参考

MySQL 错误 1264:列的值超出范围

某个数字对列的类型来说太大或太小,例如将 300 放入 TINYINT 或将负值放入 UNSIGNED 列。

错误编号
1264
名称
ER_WARN_DATA_OUT_OF_RANGE
SQLSTATE
22003
类别
数据值
错误信息
Out of range value for column '%s' at row %ld

它的意思

每种数字类型都有一个范围: TINYINT 是 -128 到 127(无符号为 0 到 255), INT 约 ±21 亿, DECIMAL(5,2) 最多到 999.99。超出该范围的值在严格模式下会导致 1264 错误,否则会被剪裁到最近的限制并发出警告。

常见原因

  • 一个 INT 超出其类型所能表示范围的 ID 或计数器。
  • 中的负值 UNSIGNED 列,有时来自一次减法,发生在一个 UPDATE.
  • A DECIMAL 小数点前的数字太少。

如何修复它

  1. 加宽该列。

    ALTER TABLE orders MODIFY id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT;
    ALTER TABLE products MODIFY price DECIMAL(10,2) NOT NULL;
  2. 为无符号列的减法加一道防护。

    UPDATE stock SET qty = GREATEST(CAST(qty AS SIGNED) - 5, 0) WHERE product_id = 7;

安全地复现它

CREATE TEMPORARY TABLE t (n TINYINT);
INSERT INTO t VALUES (300);  -- ERROR 1264 (22003)

相关错误

更多数据值错误

代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 MySQL

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