MySQL 大小寫敏感導致 Table doesn't exist 錯誤排查與永久修復

MySQL 表名大小寫敏感陷阱：Error 1146 根因與徹底解決

現象：程式碼中表名大寫 SELECT * FROM ABC，資料庫實際表名小寫 abc。Windows 下正常，Linux 部署後報 Table 'ABC' doesn't exist。

根本原因

• Windows：檔案系統不區分大小寫，MySQL 預設 lower_case_table_names=1 (表名存儲為小寫、比較不區分大小寫)。
• Linux/Unix：檔案系統區分大小寫，MySQL 預設 lower_case_table_names=0 (表名區分大小寫、按建表時大小寫存儲)。
• MacOS：預設 lower_case_table_names=2 (存儲按給定大小寫、比較轉小寫)。

驗證方法

mysql> SHOW VARIABLES LIKE 'lower_case_table_names';
+------------------------+-------+
| Variable_name          | Value |
+------------------------+-------+
| lower_case_table_names | 0     |
+------------------------+-------+

永久修復方案 (修改配置檔)

# /etc/my.cnf 或 /etc/mysql/my.cnf
[mysqld]
lower_case_table_names = 1

重啟 MySQL 生效：service mysql restart (或 systemctl restart mysqld)

效果：表名統一轉小寫存儲、比較不區分大小寫，Windows/Linux 行為一致。

⚠️ 關鍵風險與遷移注意

• 現有表名含大寫字母：修改參數後，MySQL 會嘗試以小寫尋找 .frm/.ibd 檔案，導致原表「消失」。
• 遷移步驟：
  1. 備份資料：mysqldump --all-databases > backup.sql
  2. 修改 lower_case_table_names=1 並重啟
  3. 還原資料：mysql < backup.sql (表名會自動轉小寫)
  4. 驗證應用查詢正常
• 生產環境謹慎變更：評估影響範圍，安排維護窗口，必要時採用雙寫遷移。

無權限修改配置時的應用層規範

1. 統一表名小寫：建表、查詢、ORM 映射全部使用小寫 (如 user_order)。
2. 反引號包裹：SELECT * FROM \`UserOrder\` 避免保留字衝突，但不解決大小寫問題。
3. ORM 配置：Hibernate hibernate.physical_naming_strategy、JPA @Table(name="user_order") 顯式指定小寫。

最佳實踐總結