Windows 文件系統(NTFS/FAT32)不區分大小寫,導致 MySQL 在 Windows 上預設將表名轉為小寫存儲。若開發環境(Windows)與生產環境(Linux)大小寫策略不一致,會引發「Table doesn't exist」或遷移後 SQL 報錯。本文詳細說明 lower_case_table_names 三種模式、配置方法及跨平台遷移最佳實踐。
參數三種取值對比
| 值 | 行為 | 適用場景 |
| 0 | 按建表語句大小寫存儲;查詢區分大小寫 | Linux 生產環境(預設) |
| 1 | 表名存儲為小寫;查詢轉小寫比較(不區分大小寫) | Windows 預設,避免文件系統限制 |
| 2 | 按建表大小寫存儲;查詢轉小寫比較 | Windows 需保留大小寫結構,但查詢不區分大小寫 |
Windows 配置步驟
- 編輯
my.ini(通常在 C:\ProgramData\MySQL\MySQL Server 5.7\my.ini 或安裝目錄)
- 在
[mysqld] 區塊添加:
lower_case_table_names=2
- 重啟 MySQL 服務:
net stop mysql && net start mysql 或服務管理器重啟。
- 驗證:
mysql> SHOW VARIABLES LIKE 'lower_case_table_names';
+------------------------+-------+
| Variable_name | Value |
+------------------------+-------+
| lower_case_table_names | 2 |
+------------------------+-------+
遷移血淚教訓與最佳實踐
❌ 典型慘案
- 開發機 Windows
lower_case_table_names=1,建表 User_Info 實際存為 user_info。
- 代碼寫
SELECT * FROM User_Info,Windows 下能跑。
- 遷移到 Linux(預設 0),報錯
Table 'db.User_Info' doesn't exist(實際表名 user_info)。
✅ 跨平台統一規範
- 代碼規範: 所有 SQL、ORM 實體類、Migration 腳本統一使用小寫+下劃線(snake_case),如
user_info、order_detail。
- 配置統一: 開發/測試/生產環境 全部設為 0(Linux 原生),Windows 強制
lower_case_table_names=0 並確保數據目錄在區分大小寫的卷上(NTFS 支援大小寫敏感屬性,需啟用)。
- 遷移檢查: 用
pt-table-checksum 或 mysqldump --no-data 對比結構大小寫。
特別提醒
- 修改參數需重新初始化數據目錄(刪除
datadir 內容、重新 mysqld --initialize),否則舊表文件大小寫不變,導致不一致。
- InnoDB 系統表空間(
ibdata1)也記錄表名大小寫,務必全量重建。
- 第三方工具備份/還原時注意大小寫保持(
mysqldump 預設保留建表語句大小寫)。
表名大小寫敏感度是跨平台部署的隱形殺手。源頭治理:代碼規範統一 snake_case,環境配置統一 0,才能徹底杜絕「在我機器上能跑」的低級故障。
copyright ©
萬盛學電腦網 all rights reserved