MySQL max_prepared_stmt_count报错：预处理语句回收与清理方案咨询

针对你遇到的Can't create more than max_prepared_stmt_count statements问题，我从驱动配置、语句回收、应急清理三个方面给你落地解决方案：

1. 正确回收预处理语句，避免长期累积 #

你使用的node-mysql2虽然官方文档未明确提及，但maxPreparedStatements这个配置项确实是用来控制单个连接上的预处理语句缓存上限的。当单个连接的预处理语句数量达到设定值时，驱动会自动清理最久未使用的语句，从根源上避免每个连接无限制累积语句，最终触达全局的max_prepared_stmt_count上限。

修改连接池配置 #

在创建连接池时添加这个配置，建议根据业务量设置合理值（比如1000，可根据实际场景调整）：

import mysql from 'mysql2/promise'
const pool = mysql.createPool({ 
  host, 
  port, 
  connectionLimit: 100,
  maxPreparedStatements: 1000 // 每个连接最多缓存1000个预处理语句
})
export default pool

你之前调大全局max_prepared_stmt_count到100万仍会触达，核心原因是这个值是所有连接的总配额。100个连接如果每个都累积大量语句，很容易就突破100万上限。而maxPreparedStatements限制了单个连接的语句数，能把全局总数牢牢控制在合理范围（比如100*1000=10万），彻底解决长期累积的问题。

2. 达到上限时的临时应急清理 #

如果已经触发了超限错误，可以通过以下MySQL命令快速清理全局预处理语句缓存：

FLUSH PREPARED STATEMENTS;

这个命令会立即清空所有已准备的语句，释放占用的配额。注意：执行时正在运行的预处理语句会被中断，建议在业务低峰期操作。

如果需要针对单个连接清理特定语句，可使用：

DEALLOCATE PREPARE 你的预处理语句名称;

但应急场景下，全局FLUSH的效率更高。

补充说明 #

配置maxPreparedStatements后，驱动会自动管理语句的回收，一般不需要再手动定期清理。如果你的业务有频繁执行一次性独特SQL的场景，可以考虑定期执行FLUSH PREPARED STATEMENTS作为补充，但这不是必须操作。

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