MySQL 資料庫與表名大小寫敏感性完整解析：跨平台避坑指南

MySQL 的資料庫與表名大小寫敏感性由底層作業系統檔案系統決定，這導致跨平台部署時極易踩坑。本文深度解析機制原理、平台差異、配置控制參數與最佳命名規範，助你構建跨平台相容的資料庫架構。

核心機制：檔案系統決定敏感性

MySQL 將每個資料庫對應一個目錄，每張表對應一或多個檔案（.frm 定義、.ibd/.MYD 資料、.MYI 索引）。因此：

• Windows (NTFS/FAT32)：大小寫**不敏感** → mytable、MYTABLE、MyTable 指向同一張表
• Linux/Unix (ext4/xfs)：大小寫**敏感** → 三者視為不同表
• macOS (HFS+ 預設)：大小寫**不敏感** 但保留大小寫；UFS 卷則敏感

實戰陷阱與錯誤示範

陷阱 1：同一查詢中混用大小寫（Windows 也會報錯）

-- 錯誤：Windows 下也會失敗
SELECT * FROM my_table WHERE MY_TABLE.col = 1;
-- ERROR 1146: Table 'test.MY_TABLE' doesn't exist

原因：查詢解析器在同一語句內對同一表的不同別名視為不同物件。

陷阱 2：表別名區分大小寫（所有平台）

-- 錯誤：別名 'a' 與 'A' 不同
SELECT col_name FROM tbl_name AS a WHERE a.col_name = 1 OR A.col_name = 2;
-- ERROR 1054: Unknown column 'A.col_name'

陷阱 3：跨平台遷移失敗

• 開發環境 Windows 建表 UserOrder
• 生產環境 Linux 查詢 SELECT * FROM userorder → Table doesn't exist

lower_case_table_names 參數完整解析

此參數控制 MySQL 內部儲存與比對時的大小寫處理：

修改方式一：啟動參數（臨時生效）

# 停止服務
/etc/init.d/mysql stop
# 或
systemctl stop mysqld

# 啟動帶參數
mysqld_safe --lower_case_table_names=1 &

修改方式二：配置檔永久生效（推薦）

[mysqld]
lower_case_table_names=1

⚠️ 關鍵警告：修改此參數**必須**先將現有所有表名轉為小寫，否則 MySQL 找不到原表（檔案系統仍是舊大小寫檔名）。

最佳命名規範：一致性勝過一切

1. 全域小寫 + 底線分隔：user_order、order_item、sys_config
2. 資料庫名同規則：mall_order、mall_user
3. 欄位名同規則：user_id、created_at
4. 索引/外鍵/約束名同規則：idx_user_email、fk_order_user
5. 禁止使用：大寫字母、中文、特殊符號（除底線）、保留字

跨平台部署檢查清單

特殊場景處理

遷移既有大小寫混用資料庫至 Linux

1. 來源庫執行 RENAME TABLE `OldName` TO `oldname` 逐表重命名（或寫腳本批量）
2. 導出結構與資料：mysqldump --lower-case-table-names=1
3. 目標庫配置 lower_case_table_names=1 後導入

第三方軟體強制大小寫表名

• 建立小寫視圖映射：CREATE VIEW usertable AS SELECT * FROM `UserTable`
• 或使用 ProxySQL 改寫查詢重寫規則

總結

MySQL 大小寫敏感性本質是檔案系統特性投射。**統一配置 lower_case_table_names=1` + 全域小寫命名規範** 是跨平台零成本、零風險的最佳方案。建議在專案啟動日即納入架構規範，避免後期遷移付出巨大代價。