1. 连接池已关闭异常到底在说什么Cannot perform this operation because the connection pool has been closed这句话直译过来就是连接池已经关了你还想从里面拿连接所以直接抛异常。它不是一个数据库连不上的错误而是池子生命周期已经结束但代码还在向它要资源。理解这一点很关键因为很多人第一反应是去查网络、查账号密码方向就偏了。这个异常在 Android 的SQLiteConnectionPool里最典型堆栈长这样throwIfClosedLocked→waitForConnection→acquireConnection→SQLiteSession.acquireConnection。你顺着看会发现真正报错的位置是throwIfClosedLocked也就是关闭状态检查这一步。池子被close()之后任何acquireConnection都会命中这个检查。它适合谁看如果你在写 Java/Android 应用运行一段时间后偶发这个异常或者你在用 HikariCP、Druid 这类连接池时遇到类似的 pool has been closed / dataSource has been closed这篇都能对上。核心就三件事连接池什么时候被关、谁在关它、关完之后还有谁在用它。我先把结论摆出来绝大多数情况下根因不是连接池配置太小而是生命周期管理错位——池子被提前关闭或者被多个线程/多个组件共享后其中一个把它关了。下面从生命周期、超时回收、配置参数三个角度拆开讲再给一套可复制的配置骨架最后接上 TaoToken 统一 Key 的接入方式让模型调用和数据库配置都收敛到一处管理。2. 连接池生命周期与超时回收的根因定位2.1 池子被关闭的三种典型路径第一种是显式关闭。代码里调用了db.close()或dataSource.close()之后又有异步任务、后台线程、回调去查库。Android 里最常见的就是 Activity 销毁时关了 helper但一个延迟执行的 Handler 或线程还在跑查询。第二种是作用域错配。把SQLiteOpenHelper或连接池对象放在某个短生命周期组件里比如一次请求的局部变量请求结束对象被回收池子跟着关但缓存或单例里还留着引用。第三种是超时回收 复用。连接池有maxLifetime、idleTimeout这类参数连接被回收本身正常但如果池子整体被判定空闲而关闭后续请求就会撞上关闭检查。HikariCP 的HikariDataSource在close()后getConnection()就会抛SQLException: HikariDataSource ... has been closed逻辑同源。2.2 用日志把谁关的揪出来光看异常堆栈不够因为抛异常的地方是受害者不是凶手。你要在关闭动作上加日志。以 Android 为例包一层public class TracedSQLiteOpenHelper extends SQLiteOpenHelper { private static final String TAG DBHelper; public TracedSQLiteOpenHelper(Context ctx, String name, int version) { super(ctx, name, null, version); } Override public synchronized void close() { Log.w(TAG, close() called, stack Log.getStackTraceString(new Throwable())); super.close(); } }跑一遍复现路径日志里会打印出调用close()的完整堆栈。谁在什么线程、什么时机关的池子一目了然。这一步比盲目改配置有效得多。2.3 超时参数怎么影响关闭判定连接池的关闭分两层单条连接的回收和整个池的关闭。前者由idleTimeout、maxLifetime控制后者通常由显式close()或容器生命周期触发。很多人把maxLifetime设得比数据库服务端的wait_timeout还大导致连接被服务端先掐断池子拿到的是死连接重连过程中如果池子状态异常也会出现已关闭的误判。一个稳妥的经验maxLifetime比数据库wait_timeout小 30 秒左右idleTimeout设为maxLifetime的一半以内。下面给具体配置。3. 可复制的连接池配置骨架3.1 HikariCP 配置服务端 Java 通用spring: datasource: hikari: pool-name: main-pool maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1740000 keepalive-time: 300000 connection-test-query: SELECT 1 validation-timeout: 5000max-lifetime设 1740000 毫秒29 分钟比 MySQL 默认wait_timeout28800 秒小很多避免拿到被服务端回收的连接。keepalive-time定期探活减少死连接。3.2 Android SQLite 的正确持有方式Android 的SQLiteOpenHelper本身不是线程安全的共享对象正确做法是单例持有 不主动 closepublic class DbManager { private static volatile TracedSQLiteOpenHelper helper; public static SQLiteDatabase getDb(Context ctx) { if (helper null) { synchronized (DbManager.class) { if (helper null) { helper new TracedSQLiteOpenHelper( ctx.getApplicationContext(), app.db, 1); } } } return helper.getWritableDatabase(); } }注意用getApplicationContext()避免持有 Activity 引用导致泄漏并且不要在业务代码里调helper.close()让它在进程生命周期内一直存活。进程结束系统会回收不需要你手动关。3.3 查询后必须关 Cursor异常堆栈里出现SQLiteCursor.fillWindow、moveToNext说明查询结果集还在被遍历。Cursor 不关会占着连接配合池子关闭就炸。用 try-with-resourcestry (Cursor c db.rawQuery(SELECT * FROM user WHERE age ?, new String[]{18})) { while (c.moveToNext()) { String name c.getString(c.getColumnIndexOrThrow(name)); // 处理数据 } }Cursor 自动关闭连接及时归还池子压力小很多。4. TaoToken 统一 Key 接入 settings.json数据库配置收敛好了模型调用这块也建议统一管理避免 Key 散落在各个文件里。TaoToken 提供统一的 API 入口把模型对话、编码等能力收敛到一个 Key 上。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。4.1 获取 Key 并写入 settings.json先在控制台创建 API Key地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。拿到 Key 后在项目根目录建settings.json{ taotoken: { apiKey: sk-你的Key, baseUrl: https://taotoken.net/api, model: claude-sonnet-4-5, timeoutMs: 60000 }, database: { poolName: main-pool, maxLifetimeMs: 1740000 } }把数据库和模型配置放同一个文件环境切换时只改一处。Key 的管理入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 可以按项目建多个 Key 做隔离。4.2 Java 侧读取配置import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.File; public class SettingsLoader { private static JsonNode root; public static synchronized JsonNode load() throws Exception { if (root null) { ObjectMapper mapper new ObjectMapper(); root mapper.readTree(new File(settings.json)); } return root; } public static String taotokenKey() throws Exception { return load().path(taotoken).path(apiKey).asText(); } }读取后传给 HTTP 客户端即可。模型对话的调试入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 可以先用它验证 Key 是否可用再写进代码。4.3 长期编码场景用 Coding Plan如果你是在做持续性的编码任务或 Agent 开发频繁调用模型建议看下 Coding Plan地址 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它更适合长周期、高频次的调用场景比按次计费更划算。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言的完整示例。5. 验证请求与成功结果确认5.1 复现原异常先写一段能稳定复现的代码在子线程里延迟 2 秒查库主线程立刻关闭 helper。new Thread(() - { try { Thread.sleep(2000); } catch (InterruptedException ignored) {} SQLiteDatabase db helper.getWritableDatabase(); // 这里会抛异常 db.rawQuery(SELECT 1, null).close(); }).start(); helper.close(); // 提前关闭跑起来应该能看到Cannot perform this operation because the connection pool has been closed说明复现成功。5.2 修复后验证把helper.close()去掉改用单例持有再跑一遍。子线程能正常拿到连接日志里不再出现throwIfClosedLocked。同时观察TracedSQLiteOpenHelper的 close 日志确认没有意外的关闭调用。5.3 验证 TaoToken 配置用 curl 验证 Key 和 baseUrl 是否通curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-你的Key \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-5, max_tokens: 64, messages: [{role: user, content: ping}] }返回带content字段的 JSON 就说明配置正确。如果返回鉴权错误去 API Keys 页面核对 Key 是否复制完整。6. 本篇常见错误排查清单错误一在 Activity 的 onDestroy 里关 helper。这是最常见的坑。改成单例 Application 上下文进程存活期间不关。错误二Cursor 没关。堆栈里出现fillWindow、moveToNext基本就是它。全部换成 try-with-resources。错误三多线程共享一个 helper 还手动 close。SQLite 不支持多线程同时写但读可以并发。用单例后不要在任何线程里 close交给系统回收。错误四HikariCP 的 maxLifetime 大于数据库 wait_timeout。连接被服务端先断池子拿到死连接。把 maxLifetime 调到比 wait_timeout 小 30 秒。错误五settings.json 里 Key 写错或漏了 baseUrl。表现为 401 或连接超时。用上面的 curl 先验证再写进代码。Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite baseUrl 固定为 https://taotoken.net/api 。错误六把连接池对象放在局部变量里。方法结束对象被回收池子跟着关。改成静态单例或交给 Spring 容器管理。排查顺序建议先加 close 日志定位谁关的池子再检查 Cursor 是否泄漏最后核对超时参数。三步走下来这个异常基本能根治。数据库配置和模型 Key 都收敛到 settings.json 之后环境切换和团队协作会省心很多。