MySQL 大小寫敏感導致 Table doesn't exist 錯誤的根因與解決

錯誤現象

開發環境（Windows）一切正常，部署到 Linux 服務器後報錯：

MySQL Error 1146: Table 'ABC' doesn't exist

但表明明存在，且 phpMyAdmin 用小寫 abc 可正常查詢，權限也無問題。

核心原因：作業系統層級的大小寫敏感差異

MySQL 將表名映射為文件名（.frm/.ibd），Linux 下 ABC ≠ abc，故查詢 ABC 找不到對應文件。

三種解決方案

方案一：統一代碼規範（推薦，零配置修改）

• 代碼中全部使用小寫表名，或與建表語句大小寫完全一致。
• ORM 框架配置 naming_strategy=lower_case（Hibernate/JPA）或 table_prefix 統一前綴。
• 優點：跨平台無縫遷移，無需改動服務器配置。

方案二：修改 MySQL 配置啟用大小寫不敏感（需重啟）

# /etc/my.cnf 或 /etc/mysql/my.cnf
[mysqld]
lower_case_table_names = 1

關鍵步驟：

1. 停止 MySQL：systemctl stop mysqld
2. 備份數據目錄（datadir）
3. 修改配置並重啟：systemctl start mysqld
4. 驗證：SHOW VARIABLES LIKE 'lower_case_table_names'; 應返回 1

注意：
• 遷移現有庫需先 mysqldump 導出，修改配置後重建導入。
• InnoDB 表名存儲在系統表空間，直接改配置可能導致舊表不可訪問。

方案三：建表時強制小寫（MySQL 8.0+）

CREATE TABLE `abc` (...) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

配合 lower_case_table_names=1，新表自動轉小寫存儲。

最佳實踐總結

1. 開發規範：團隊統一約定「庫、表、列全小寫 + 下劃線分隔」。
2. CI/CD 檢查：在 Pipeline 中加入 mysqlcheck --check-upgrade 或自定義腳本掃描 SQL 中的大寫表名。
3. 容器化部署：Docker 構建鏡像時預置 lower_case_table_names=1，消除環境差異。

細節決定成敗，跨平台部署前務必驗證大小寫敏感設置，避免上線後「表明明存在卻查不到」的低級事故。