第一次在监控里看到 invalid input syntax for type numeric 这个报错时,我盯着日志愣了几秒:这行数据在页面表格里明明显示的是 123.45,怎么落到数据库就变成非法输入了?后来我才真正理解,PostgreSQL 这个报错背后其实是两件事:一是有个字符串正在被隐式或显式地转换为 numeric 类型,二是这个字符串的内容不符合 numeric 的语法规则,PostgreSQL 连一个多余的空格都不肯放过。这篇文章不是教科书,而是把我排查这类问题过程中踩过的坑、用过的 SQL、修复过的事故,原原本本整理出来。无论你是刚接触 PostgreSQL 的新手,还是正在被线上数据问题折磨的一线开发,这篇都值得花十分钟读完。
1. 这个报错的信息量比你想的大:不只是"字符串不能转数字"
1.1 拆开这行错误信息:谁在转、转什么、为什么失败
PostgreSQL 抛出的错误格式通常是这样的:
text复制ERROR: invalid input syntax for type numeric: "XXXX"
这行信息可以拆成三层来看:
- invalid input syntax:输入语法不合法。也就是说,某个字符串没通过 PostgreSQL 词法层面的数字格式校验。
- for type numeric:目标类型是
numeric。说明 PostgreSQL 正在把这个值往数字类型上转换,而不是往text、varchar这类字符类型上传。 - "XXXX":触发错误的原始字符串。注意,这个值在日志里可能是空字符串、可能是一段文本、也可能是很长的一段字符被人为截断后的样子。它本身只是"压垮骆驼的那根稻草",并不代表全表只有这一行有问题。
搞清楚谁在转换,往往比纠正报错本身更重要。PostgreSQL 触发这种转换的时机主要有三类:
显式转换,也就是你自己写了类型转换,比如 amount::numeric、CAST(amount AS numeric)。这类报错最好查,因为范围就锁死在那一行 SQL 上。
隐式转换,这是最常见也最隐蔽的一类。比如表里有个字段是 varchar,你的应用往 numeric 字段里插值,或者你在 WHERE 条件里把字符串列和数字字面量做比较,PostgreSQL 会自动尝试把字符串转换成数字。只要有一行脏数据,整条 SQL 直接报错。
视图和函数内部的参数传递。视图里定义了 varchar 到 numeric 的逻辑,应用层传参不规范,也会触发同样的错误。
所以看到这个错误时,不要急着去改代码,先问自己一句:这个转换发生在哪一层?是显式写的,还是 PostgreSQL 在背后偷偷做的?
1.2 numeric 类型能接受什么写法
PostgreSQL 对 numeric 输入的校验严格到什么程度?我说几个很反直觉的例子。
| 输入 | 转换结果 | 说明 |
|---|---|---|
'123' |
123 |
最基础的整数写法 |
'-123.45' |
-123.45 |
常规小数 |
'+123' |
123 |
正号被识别 |
'123.' |
123 |
末尾小数点合法 |
'.5' |
0.5 |
小数点开头不报错 |
'1e3' |
1000 |
科学计数法合法 |
'1.2e-3' |
0.0012 |
负指数合法 |
以下这些,PostgreSQL 全部拒绝,一个都不商量:
| 输入 | 报错 | 说明 |
|---|---|---|
'' |
报错 | 空字符串,最常见的元凶 |
' ' |
报错 | 纯空格也不行 |
' abc ' |
报错 | 两边有空格,仍然报错 |
'1,000' |
报错 | 千分位符号不支持 |
'$100' |
报错 | 货币符号不支持 |
'(123.45)' |
报错 | 会计用的括号负数不支持 |
'123' |
报错 | 全角数字不支持 |
'1 000' |
报错 | 中间有空格不支持 |
'N/A' |
报错 | 业务常用的占位符不支持 |
这个严格程度有点像编程语言里把字符串解析成整数,但比绝大多数编程语言还要"较真":很多语言里的 parseFloat 还能容忍前后空格,PostgreSQL 直接零容忍。
这种设计其实是有道理的:数据库的职责是保证数据可靠性,它宁可拒绝一个格式模糊的值,也不能用一个拍脑袋的规则去猜测你想要的数字到底是 1000 还是 1 000。只是这种严格,落到业务上就成了各种"看起来明明是数字,数据库却说不合法"的困惑。
1.3 为什么数据看起来是数字,系统却说非法
我在一线排查时发现,绝大多数"幽灵脏数据"并
