Vert.x3.9.8调用PreparedStatement.close概率抛出IllegalStateException问题

安全阿岳

2026-10-11

异常触发原因

该异常是Vert.x 3.9.8版本SQL客户端的实现特性导致的：

PreparedStatement实例与具体的数据库连接强绑定，调用preparedStatement.close()时，底层会向绑定的连接提交调度任务执行关闭指令
当连接已经因为网络波动、空闲超时被池回收、物理断开等原因处于非OPEN状态时，SocketConnectionBase的schedule方法会直接抛出IllegalStateException，拒绝处理新任务
现有代码中没有判断连接可用性就直接调用preparedStatement.close()，当上述场景出现时就会触发该异常。另外prepare失败的分支中，ar.result()本身大概率为空，该分支的手动关闭逻辑本身也无实际意义。

可行修复方案

方案1：直接删除手动关闭PreparedStatement的逻辑
Vert.x的数据库连接在关闭（或归还连接池）时，会自动清理该连接上绑定的所有预编译语句资源，无需业务代码手动处理，是成本最低的修复方案。

方案2：增加状态判断后再关闭
若确实需要手动关闭，执行关闭前先校验连接可用性：

// 执行execute后的回调分支中替换原关闭逻辑
if (!connection.isClosed() && preparedStatement != null) {
    preparedStatement.close();
}
connection.close();

方案3：捕获预期内的异常
对关闭操作增加异常捕获，忽略连接已关闭场景下的报错：

try {
    if (preparedStatement != null) {
        preparedStatement.close();
    }
} catch (IllegalStateException ignore) {
    // 连接已关闭，预编译语句资源已被自动释放，无需额外处理
}
connection.close();