Prepared_stmt_count接近max_prepared_stmt_count表明预处理语句未释放,需通过performance_schema.prepared_statements_instances定位泄漏连接并检查代码close路径。

查 Prepared_stmt_count 和 max_prepared_stmt_count 实时状态
先确认是否真被耗尽:执行 SHOW GLOBAL STATUS LIKE 'Prepared_stmt_count'; 和 SHOW VARIABLES LIKE 'max_prepared_stmt_count';。如果前者接近甚至等于后者,且持续增长不回落,基本可判定存在未释放的预处理语句。
注意:Prepared_stmt_count 是全局累计值,重启后归零;但若应用长期运行中该值只增不减,说明客户端没调用 close() 或连接池未正确回收。
-
Prepared_stmt_count = 1998+max_prepared_stmt_count = 2000→ 已濒临上限,Can't create more than max_prepared_stmt_count statements随时会报 - 该指标不区分线程,无法定位具体是哪个连接在“漏”,需进一步下钻
- 某些旧版 MySQL(如 5.7)中,
Prepared_stmt_count在连接断开时未必清零,可能残留,需结合performance_schema验证
用 performance_schema.prepared_statements_instances 查活体实例
这是最直接的证据来源:它记录当前所有存活的预处理语句(含 SQL 文本、创建线程 ID、内存占用等)。必须确保 performance_schema 已启用(MySQL 5.6+ 默认开),且相关消费者已打开:
UPDATE performance_schema.setup_consumers SET ENABLED = 'YES' WHERE NAME = 'events_statements_current';UPDATE performance_schema.setup_instruments SET ENABLED = 'YES' WHERE NAME = 'statement/sql/prepare_sql';
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 执行
SELECT STATEMENT_ID, SQL_TEXT, OWNER_THREAD_ID, OBJECT_SCHEMA, OBJECT_NAME, CURRENT_NUMBER_OF_BYTES_USED FROM performance_schema.prepared_statements_instances ORDER BY CURRENT_NUMBER_OF_BYTES_USED DESC LIMIT 10;→ 看哪些 SQL 占内存最多、属于哪个线程 - 用
OWNER_THREAD_ID关联performance_schema.threads表,查出对应连接的PROCESSLIST_ID、PROCESSLIST_USER、PROCESSLIST_INFO,定位到具体应用连接 - 如果看到大量重复 SQL 模板(如
SELECT * FROM orders WHERE id = ?)但OWNER_THREAD_ID分散且长期存在,大概率是连接池未复用或未关闭 PreparedStatement
结合线程内存使用看真实影响
单条预处理语句本身内存不大,但累积 + 关联结果集(尤其大查询)会显著推高 per-thread 内存。不能只盯 preparedStatement 对象,要看它背后占了多少 server 层内存:
SELECT t.PROCESSLIST_ID, t.PROCESSLIST_USER, t.PROCESSLIST_HOST, m.CURRENT_NUMBER_OF_BYTES_USED / 1024 / 1024 AS mb_used FROM performance_schema.threads t JOIN performance_schema.memory_summary_by_thread_by_event_name m ON t.THREAD_ID = m.THREAD_ID WHERE m.EVENT_NAME = 'memory/sql/Prepared_statement' AND m.CURRENT_NUMBER_OF_BYTES_USED > 0 ORDER BY mb_used DESC;
- 这条语句能筛出哪些连接在线程级为预处理语句分配了显著内存(单位 MB)
- 若某连接
mb_used达几 MB 以上,再结合其PROCESSLIST_INFO(如长时间执行SELECT ... LIMIT 10000),基本可断定是 ResultSet 缓存未释放导致(见 JDBC 的rowData持有机制) - 注意:
memory/sql/Prepared_statement是 MySQL server 层统计,不包含 JDBC 客户端堆内对象;客户端泄漏需另查 JVM heap dump
验证代码是否真释放:对比 Prepared_stmt_count 增量
不要依赖日志或“我以为 close 了”。最可靠的方式是做一次可控压测:
启动前记下 SHOW GLOBAL STATUS LIKE 'Prepared_stmt_count'; 值 A;
执行固定次数(如 100 次)带 PreparedStatement 的查询,并确保每次显式调用 ps.close();
结束后再查值 B;
若 B - A > 100(允许少量波动),说明仍有泄漏路径未覆盖——比如异常分支没 close、try-with-resources 未生效、或连接被归还池前未清理。
- 常见坑:Spring JdbcTemplate 默认自动 close,但手动用
Connection.prepareStatement()后忘关;MyBatis 中<foreach></foreach>动态生成大量预处理语句却未配置useServerPrepStmts=false - MySQL 连接串加
useServerPrepStmts=true&cachePrepStmts=true会加剧问题:缓存放大 + 服务端不感知客户端 close,必须靠连接归还时显式清理 - 真正难排查的是“伪释放”:JDBC 驱动 close 了 statement,但 MySQL server 因连接未断开,仍保留其元数据 —— 此时
Prepared_stmt_count不降,得靠连接池配置removeAbandonedOnBorrow=true或定期重连来兜底
关键点在于:server 层的 prepared statement 生命周期不由客户端 close 单方面决定,而受连接状态、驱动行为、服务端配置三者共同作用。只改 max_prepared_stmt_count 是掩耳盗铃,必须从代码 close 路径、连接池回收策略、以及 performance_schema 的实时实例三处交叉验证。

















