MySQL ERROR 1615 (HY000) Prepared statement needs to be re-prepared 根因與解決

MySQL ERROR 1615 (HY000) Prepared statement needs to be re-prepared 根因與解決

報錯 ERROR 1615 (HY000): Prepared statement needs to be re-prepared 通常發生在大量表結構變更 (DDL) 導致預處理語句緩存失效。本文分析根因並給出生產級調優方案。

一、錯誤觸發機制

• MySQL 為每個 Prepared Statement 維護元數據版本號。
• 表結構變更 (ALTER TABLE、TRUNCATE、ANALYZE、統計信息更新) 會使版本號增長。
• 執行時發現版本不匹配，嘗試自動重新準備；若 table_definition_cache / table_open_cache 過小，導致表定義被驅逐，無法重新準備，拋出 1615。

二、核心參數調優

-- 臨時生效 (重啟失效)
SET GLOBAL table_open_cache = 16384;
SET GLOBAL table_definition_cache = 16384;

-- 永久生效 (my.cnf)
[mysqld]
table_open_cache = 16384
table_definition_cache = 16384

三、參數含義

四、排查步驟

1. SHOW GLOBAL STATUS LIKE 'Opened_tables'; 持續增長說明緩存不足。
2. SHOW GLOBAL STATUS LIKE 'Prepared_stmt_count'; 觀察預處理語句數量。
3. 檢查是否有頻繁 DDL 或大量分表操作的應用。
4. 適當增大上述兩參數，觀察錯誤是否消失。

五、最佳實踐

• 避免業務高峰期執行 DDL，使用 pt-online-schema-change 或 gh-ost 在線變更。
• 連接池配置 cachePrepStmts=true、prepStmtCacheSize 合理複用預處理語句。
• 監控 table_open_cache_overflows、table_definition_cache_overflows 指標。