Linux 下 MySQL 大小寫敏感性配置詳解：lower_case_table_names 參數最佳實踐

問題現象

開發環境 Windows（不區分大小寫）程式碼部署至 Linux 生產環境（預設區分大小寫）後，報錯「Table doesn't exist」，實際表名存在但大小寫不匹配。

Linux MySQL 預設大小寫規則

解決方案：配置 lower_case_table_names

1. 編輯 /etc/my.cnf（或 /etc/mysql/my.cnf），在 [mysqld] 區段新增：
   lower_case_table_names=1
2. 重啟 MySQL 服務：
   systemctl restart mysqld 或 service mysql restart

參數值含義

• 0（Linux 預設）：**區分大小寫**，表名按建立時大小寫存儲於磁盤，查詢需精確匹配。
• 1：**不區分大小寫**，表名以小寫存儲於磁盤，查詢自動轉小寫比對（Windows 行為）。
• 2：表名按建立時大小寫存儲，但查詢轉小寫比對（罕用，易引發不一致）。

最佳實踐建議

1. 統一規範：專案初期即規定「所有資料庫、表、列名全小寫、下劃線分隔」，從代碼層面消除大小寫差異，避免依賴參數。
2. 遷移專案：若歷史代碼大小寫混用且無法重構，在**從庫/新實例**設定 lower_case_table_names=1 並重新匯入數據，主從複制場景需主從參數一致，否則複制中斷。
3. 參數修改風險：修改 lower_case_table_names 需重啟且**要求數據目錄遷移/重建**，現有表名大小寫可能導致無法啟動或查詢異常，生產環境極謹慎變更。
4. 跨平台開發：開發機（Windows/Mac）同步設定 lower_case_table_names=1，與生產環境行為一致，提前暴露問題。

驗證命令

SHOW VARIABLES LIKE 'lower_case_table_names';
# Value = 1 表示已生效