MySQL 大小寫敏感問題全解析：表名、列名、字符集三大維度

MySQL 大小寫敏感問題全解析：表名、列名、字符集三大維度

MySQL 大小寫敏感行為由作業系統文件系統、字符集校對規則、系統變量 lower_case_table_names 三者共同決定。本文系統梳理表名/列名/數據值三個層面的敏感規則，並給出跨平台遷移最佳實踐。

一、數據值比較：字符集校對規則決定

1. 列級指定 BINARY 屬性

CREATE TABLE `name` (
  `name` VARCHAR(10) BINARY  -- 區分大小寫
);

效果：WHERE name='clip' 不匹配 'Clip'。

2. SQL 語句級 BINARY 操作符

SELECT * FROM `name` WHERE BINARY name = 'Clip';

3. 字符集層面

二、表名/庫名敏感度：OS 文件系統 + lower_case_table_names

lower_case_table_names 三種取值

• 0：按聲明大小寫存儲，比較敏感（Linux 默認）。
• 1：統一轉小寫存儲，比較不敏感（Windows 默認，推薦跨平台統一值）。
• 2：按聲明大小寫存儲，比較轉小寫（macOS 默認）。

Windows 強制區分大小寫設置

# my.ini
[mysqld]
lower_case_table_names = 0

⚠ 風險：Windows 文件系統不區分大小寫，強制 0 會導致同名不同大小寫表無法共存，甚至數據損壞。生產環境強烈建議統一 1。

三、列名/別名/變量名敏感度規則

四、跨平台遷移避坑指南（Windows → Linux 高危）

1. 開發規範：代碼中統一使用小寫庫表名、列名、別名（如 user_order 而非 UserOrder）。
2. lower_case_table_names=1 全環境統一（開發/測試/生產）。
3. 導出腳本 mysqldump --lower-case-table-names=1 強制小寫導出。
4. ORM 框架配置：Hibernate hibernate.physical_naming_strategy、MyBatis mapUnderscoreToCamelCase 統一映射策略。
5. 遷移前檢查：SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA='db' AND TABLE_NAME != LOWER(TABLE_NAME); 發現大寫表名預警。

大小寫敏感不是 Bug，是特性。統一規範、配置對齊、工具輔助，讓跨平台遷移「零驚喜」。