当前位置：首页 > news >正文

PostgreSQL（十二）报错：Tried to send an out-of-range integer as a 2-byte value: 51000

news 2025/8/4 15:01:15

一、报错场景

今天写了一个历史数据处理程序，在开发环境、测试环境都可以正常执行，但是放到生产环境上就不行，报了一个这样的错误：

org.postgresql.util.PSQLException: An I/O error occurred while sending to the backend.

意思大概是：当把数据发送给后端的时候，出现了一个 I/O 异常。

完整报错截图如下：

顺着日志中异常栈信息往下看，可以看到下面有一处具体的报错原因：

Caused by: java.io.IOException: Tried to send an out-of-range integer as a 2-byte value: 51000

意思大概是：出现了一个IO异常，尝试发送一个二进制 int 类型数值时，当前数值超出了大小限制：5100

Caused by: java.io.IOException: Tried to send an out-of-range integer as a 2-byte value: 51000at org.postgresql.core.PGStream.sendInteger2(PGStream.java:359)at org.postgresql.core.v3.QueryExecutorImpl.sendParse(QueryExecutorImpl.java:1604)at org.postgresql.core.v3.QueryExecutorImpl.sendOneQuery(QueryExecutorImpl.java:1929)at org.postgresql.core.v3.QueryExecutorImpl.sendQuery(QueryExecutorImpl.java:1487)at org.postgresql.core.v3.QueryExecutorImpl.execute(QueryExecutorImpl.java:347)... 140 common frames omitted

二、源码分析

我们根据报错提示，找到源码对应的位置，该源码位于 postgresql 依赖中，Maven坐标如下：

<!--postgresql 数据库驱动依赖 -->
<dependency><groupId>org.postgresql</groupId><artifactId>postgresql</artifactId><version>42.6.0</version><scope>runtime</scope>
</dependency>

源码位置如下：

可以看到这里有一个大小限制，Short.MAX_VALUE 对应的就是 Short 类型的最大值，为 32767。也就是说，在 PostgreSQL 中，如果参数的数量超过 32767 之后，就会抛出 Tried to send an out-of-range integer 这个异常。

三、实际原因（更加复杂）

道理都懂，但是细想的话还是有以下两个问题：

我在代码中明明根据入参按照 1000 分页处理的，没有超出 32767，为什么还会报这个错？
报错信息中的 51000 又是哪来的？

于是我们继续根据上面的异常栈信息进行排查，针对第2层栈信息在本地打断点调试。

Caused by: java.io.IOException: Tried to send an out-of-range integer as a 2-byte value: 51000at org.postgresql.core.PGStream.sendInteger2(PGStream.java:359)at org.postgresql.core.v3.QueryExecutorImpl.sendParse(QueryExecutorImpl.java:1604)at org.postgresql.core.v3.QueryExecutorImpl.sendOneQuery(QueryExecutorImpl.java:1929)at org.postgresql.core.v3.QueryExecutorImpl.sendQuery(QueryExecutorImpl.java:1487)at org.postgresql.core.v3.QueryExecutorImpl.execute(QueryExecutorImpl.java:347)... 140 common frames omitted