.NET Core 3.1对接MySQL8.0报max_prepared_stmt_count超限错误如何解决

MySQL的max_prepared_stmt_count参数控制了全局允许的最大预处理语句数量，本次报错核心问题出在代码的不合理调用逻辑：

• 你复用了同一个DbCommand对象，但在每次循环遍历业务数据时都重复调用dbCmd.Prepare()，每调用一次，MySQL驱动就会在服务端生成一个新的预处理语句句柄，循环次数过多后直接打满服务端的max_prepared_stmt_count阈值。
• 每次循环内重复调用param.Prepare(dbCmd)，也会重复生成预处理参数绑定，进一步占用服务端资源。
• 如果应用未开启连接池、或者连接长期不释放，已经创建的预处理语句无法自动回收，会进一步加剧资源占用问题。

• 先确认服务端当前阈值配置，执行SQLshow variables like 'max_prepared_stmt_count';，默认值为16382，如果业务本身并发量高，该阈值可能本身不足以支撑业务需求。
• 统计批量操作的单次循环次数，确认是否存在单次循环超过阈值的情况。
• 开启MySQL通用日志，校验是否存在大量重复的预处理语句创建请求。

• 核心优化：将Prepare()调用移到循环外，预处理逻辑只需要执行一次，循环内仅更新参数值即可，修正后代码参考：

using (var dbCmd = Connection.CreateCommand())
{
    // Set the command string
    dbCmd.CommandText = CommandText;
    // Set the command type
    dbCmd.CommandType = CommandType;
    // 初始化参数结构，仅执行一次
    foreach (var param in m_parameters)
    {
        param.Prepare(dbCmd);
    }
    // 预处理命令，仅执行一次
    dbCmd.Prepare();

    // run for all events
    foreach (var e in chunk)
    {
        // 仅重置参数值，不需要清空整个参数集合
        foreach (var param in dbCmd.Parameters)
        {
            param.Value = DBNull.Value;
        }
        // 仅更新参数值，不需要重复预处理
        foreach (var param in m_parameters)
        {
            param.FormatValue(dbCmd, e);
        }
        // 直接执行命令
        dbCmd.ExecuteNonQuery();
    }
}

• 如果业务确实有大量预处理需求，可以适当调高服务端max_prepared_stmt_count阈值，例如调整到32768，执行命令set global max_prepared_stmt_count = 32768;即可生效，注意同步修改my.cnf配置避免服务重启后配置失效。
• 确认MySQL连接池配置正常，闲置连接回收逻辑正常，避免长期存活的连接累积大量未释放的预处理语句。
• 如果你使用的是MySqlConnector驱动，可以在连接参数中添加IgnorePrepare=true，由驱动本地处理预处理逻辑，不占用服务端的预处理语句资源，适合预处理语句量极大的场景。

内容的提问来源于stack exchange，提问作者Kamran Shahid