Firebird数据库连接报错：页缓冲缓存内存不足，连接池验证失效排查

首先，咱们拆解你遇到的两个核心问题：Firebird的页缓冲缓存资源耗尽错误，以及非容器管理数据源的连接验证逻辑未生效。下面一步步来梳理解决思路：

一、先搞懂错误的本质 #

这个无法分配页缓冲缓存内存 [SQLState:HY013, ISC error code:335544691]错误，本质是Firebird服务器端的页缓冲（Page Buffer Cache）资源不够用了，常见场景有：

• 连接池配置的最大连接数超过了Firebird的承载上限，同时打开的连接太多耗尽资源；
• Firebird默认的页缓冲配置过小，撑不住当前的查询负载；
• 连接池里的闲置连接被Firebird端回收了资源，但连接池还以为它有效，复用的时候就报错了。

二、确保连接验证查询被触发（针对非容器管理数据源） #

因为你用的是非容器管理型数据源，容器不会自动帮你配置连接验证逻辑，必须手动显式给连接池设置验证参数。这里给你举两个常用连接池的配置示例：

1. HikariCP（目前主流轻量连接池） #

必须手动指定Firebird专属的验证查询，并开启验证触发时机：

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:firebirdsql://your-host:3050/your-db.fdb");
config.setUsername("your-username");
config.setPassword("your-password");

// Firebird专用验证查询：用系统内置表RDB$DATABASE，确保一定能执行
config.setConnectionTestQuery("SELECT 1 FROM RDB$DATABASE");
// 每次从连接池拿连接时都验证，最直接的防无效连接方式
config.setTestOnBorrow(true);
// 可选：设置验证间隔，避免过于频繁验证消耗资源
config.setValidationInterval(30000); // 30秒
// 连接池最大连接数要匹配Firebird的MaxConnections（默认是10，建议留1-2个余量）
config.setMaximumPoolSize(8);

HikariDataSource dataSource = new HikariDataSource(config);

2. Apache DBCP2 #

同样需要配置验证查询和触发参数：

BasicDataSource dataSource = new BasicDataSource();
dataSource.setUrl("jdbc:firebirdsql://your-host:3050/your-db.fdb");
dataSource.setUsername("your-username");
dataSource.setPassword("your-password");

dataSource.setValidationQuery("SELECT 1 FROM RDB$DATABASE");
// 借连接时验证
dataSource.setTestOnBorrow(true);
// 闲置连接也定期验证
dataSource.setTestWhileIdle(true);
// 闲置验证的间隔时间
dataSource.setTimeBetweenEvictionRunsMillis(30000);
dataSource.setMaxTotal(8);

关键提醒：

• 绝大多数连接池默认是关闭连接验证的，所以必须手动开启testOnBorrow/testWhileIdle这类触发参数；
• Firebird不能用通用的SELECT 1当验证查询，必须加上FROM RDB$DATABASE，否则会直接报错。

三、从根源解决页缓冲内存不足问题 #

就算验证查询生效了，也要解决Firebird本身的资源瓶颈：

1. 调整Firebird的页缓冲配置：
   打开Firebird安装目录下的firebird.conf，找到PageBuffers参数，默认一般是2048（单位是页，每页4KB），可以根据服务器内存适当调大，比如：

   PageBuffers = 4096
   

   修改后记得重启Firebird服务。

2. 匹配连接池与Firebird的最大连接数：
   Firebird默认的MaxConnections是10，所以连接池的最大连接数别超过这个值。如果需要更多连接，先修改firebird.conf里的配置：

   MaxConnections = 20
   

四、额外排查小技巧 #

• 打开连接池的DEBUG日志，比如HikariCP的日志可以看到验证查询的执行记录，确认验证逻辑真的被触发了；
• 手动从连接池拿一个连接，执行SELECT 1 FROM RDB$DATABASE，看是否报错，直接判断连接是否有效。

内容的提问来源于stack exchange，提问作者Mkp