MongoDB报错java.lang.IllegalStateException：未主动关闭连接却提示已关闭

可能的原因及对应解决方案 #

1. 数据库实例/客户端生命周期管理不当

• 确保MongoClient是全局单例，不要每次操作都新建实例。重复创建会快速耗尽连接池，导致连接被强制关闭。
• 检查代码中是否存在意外关闭MongoClient或db1的逻辑，比如在其他地方调用了mongoClient.close()或db1.close()。

2. 连接池配置不合理或连接泄漏

• 调整连接池参数，避免连接耗尽或超时。示例配置：

MongoClientSettings settings = MongoClientSettings.builder()
        .applyConnectionString(new ConnectionString("mongodb://localhost:27017"))
        .connectionPoolSettings(ConnectionPoolSettings.builder()
                .maxPoolSize(50) // 根据业务调整最大连接数
                .maxIdleTime(30, TimeUnit.SECONDS) // 闲置连接超时回收
                .build())
        .build();
MongoClient mongoClient = MongoClients.create(settings);

• 检查另一个遍历集合的场景，必须用try-with-resources管理游标，避免连接泄漏：

try (MongoCursor<Document> cursor = anotherCollection.find().iterator()) {
    while (cursor.hasNext()) {
        Document doc = cursor.next();
        // 处理文档逻辑
    }
}

未关闭的游标会长期占用连接，最终导致连接池耗尽，驱动会自动关闭过期/闲置连接。

3. 查询操作的潜在资源问题

• 虽然.first()方法会自动关闭游标，但如果查询过程中出现异常，可能导致连接未正确释放。建议给查询操作添加异常捕获，同时处理playerDoc为null的情况（避免后续updateOne抛出空指针）：

MongoCollection<Document> playerdb = db1.getCollection("Player");
Document playerDoc = null;
try {
    playerDoc = playerdb.find(eq("uuid", p.getUniqueId().toString()))
            .projection(Projections.fields(Projections.include("guildName")))
            .first();
} catch (MongoSocketException e) {
    // 捕获连接相关异常，记录日志
    e.printStackTrace();
}

if (playerDoc != null) {
    playerdb.updateOne(playerDoc, Updates.set("guildName", name));
} else {
    // 处理文档不存在的逻辑
}

4. 服务端或网络问题

• 检查MongoDB服务端日志，确认是否有主动断开连接的情况（比如超时设置、资源不足）。
• 排查应用服务器与MongoDB之间的网络是否存在波动，导致连接被意外中断。

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