您现在的位置：程式碼之家 >> 數據庫知識 > >> MySQL 資料庫 >> MySQL 資料庫相關知識

解決 Linux MySQL 表名大小寫敏感問題：lower_case_table_names 參數配置指南

編輯：MySQL 資料庫相關知識

問題現象

Linux 環境下，程式報錯「找不到表」，但 MySQL 命令列明明能查到表存在。根因：Linux 預設表名大小寫敏感 (區分 user vs User)，而程式碼中表名大小寫不一致。

解決方案：配置 lower_case_table_names

操作步驟


# 1. 編輯配置檔
vi /etc/my.cnf

# 2. 在 [mysqld] 區段新增
lower_case_table_names = 1

# 3. 重啟 MySQL 服務
/etc/init.d/mysql restart
# 或 systemctl restart mysqld

參數值詳細說明

值	行為	適用作業系統
0 (預設 Unix/Linux)	表名區分大小寫，儲存時保持原大小寫	Linux、Unix、macOS (區分大小寫檔案系統)
1 (預設 Windows)	表名轉小寫儲存，查詢時不區分大小寫	Windows、macOS (不區分大小寫檔案系統)、Linux 強制相容
2	表名保持原大小寫儲存，但查詢時轉小寫比對	特殊需求 (保留大小寫顯示但不區分查詢)

⚠️ 關鍵遷移警示

現有資料庫需重建：修改參數後，現有表名大小寫不會自動轉換
遷移流程：
1. 備份：mysqldump --all-databases > backup.sql
2. 修改參數重啟
3. 還原：mysql < backup.sql (表名自動轉小寫)
4. 驗證應用程式查詢正常
跨平台遷移：Windows→Linux 必須設定 lower_case_table_names=1 並重建，否則大小寫不匹配導致查詢失敗

最佳實踐建議

開發規範：統一使用小寫表名、欄位名 (如 user_info)，避免跨平台大小寫陷阱
配置檔版本控制：lower_case_table_names 納入基礎設施代碼管理
Docker 部署：鏡像建構時預設配置 lower_case_table_names=1
遷移測試：上線前在測試環境完整跑通遷移流程

驗證命令


# 檢查當前設定
SHOW VARIABLES LIKE 'lower_case_table_names';

# 測試大小寫不敏感
CREATE TABLE TestTable (id INT);
SELECT * FROM testtable;  -- 應成功
SELECT * FROM TESTTABLE;  -- 應成功
DROP TABLE TestTable;