萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

Linux 下 MySQL 表名大小寫敏感問題徹底解決:lower_case_table_names=1 配置詳解

問題現場

Linux 下 MySQL 默認 表名區分大小寫 ( lower_case_table_names=0 )。代碼中表名大小寫不一致導致「找不到表」,但命令行可查詢 (因命令行可能自動匹配或實際建表大小寫一致)。

根因

  • Linux 文件系統區分大小寫,MySQL 以文件名存儲表定義 (tbl.frm、tbl.MYD、tbl.MYI),故表名區分大小寫。
  • Windows 文件系統不區分大小寫,默認 lower_case_table_names=1 (存儲為小寫,比較時轉小寫)。
  • macOS (HFS+/APFS) 默認不區分,但可配置。

解決方案:統一不區分大小寫 (跨平台兼容首選)

  1. 編輯 /etc/my.cnf (或 /etc/mysql/my.cnf):
    [mysqld]
    lower_case_table_names=1
  2. 重啟 MySQL 服務:
    systemctl restart mysqld 或 /etc/init.d/mysql restart

參數取值對照表

值存儲比較適用場景
0原樣區分大小寫Linux 默認、嚴格大小寫業務
1小寫不區分大小寫**跨平台遷移、Windows 習慣、應用層大小寫不統一**
2原樣不區分大小寫僅限不區分大小寫文件系統 (Windows/macOS)

遷移既有數據庫的完整步驟

  1. 導出結構與數據:mysqldump --routines --events --triggers -u root -p dbname > db.sql
  2. 修改 my.cnf 添加 lower_case_table_names=1,重啟服務。
  3. 導入:mysql -u root -p dbname < db.sql (表名自動轉小寫存儲)。
  4. 驗證:SHOW TABLES; 應全為小寫;SELECT * FROM TableName; (大小寫混寫) 可正常查詢。

⚠️ 關鍵警示

  • 運行中修改該參數極其危險:已有表文件大小寫不一致將導致無法訪問、數據丟失。**必須在全新實例或完成遷移後設置**。
  • InnoDB 共享表空間 (ibdata1) 內部數據字典存儲原始大小寫,修改參數後可能出現元數據不匹配。**建議使用獨立表空間 (innodb_file_per_table=1) 便於遷移**。
  • 應用層最佳實踐:**代碼中統一使用小寫表名**,杜絕大小寫混用,消除平台差異隱患。
copyright © 萬盛學電腦網 all rights reserved