解決 Linux MySQL 表不存在錯誤：大小寫敏感問題

現象描述

將應用從 Windows 遷移到 Linux 後，程序報錯：

java.sql.SQLException: Table 'xxx.TB_XXX' doesn't exist

但數據庫中明明存在表 tb_xxx（小寫）。

根因分析

• Windows：文件系統不區分大小寫，MySQL 表名存儲為文件，故不區分大小寫
• Linux：文件系統區分大小寫，MySQL 表名對應文件名，**嚴格區分大小寫**
• 應用 SQL 中使用大寫表名（TB_XXX），Linux 下找不到對應的小寫文件（tb_xxx）

解決方案：修改 MySQL 配置忽略大小寫

編輯配置文件

vim /etc/my.cnf
# 或 /etc/mysql/my.cnf

在 [mysqld] 區段添加

[mysqld]
# 1 = 不區分大小寫（表名存儲為小寫，比較時轉小寫）
# 0 = 區分大小寫（Linux 默認）
# 2 = 存儲按原大小寫，但比較轉小寫（Windows 默認）
lower_case_table_names = 1

重啟 MySQL 服務

service mysqld restart
# 或 systemctl restart mysqld

參數值詳細說明

⚠ 重要注意事項

替代方案（不修改配置）

• 統一代碼規範：應用層 SQL 全部使用小寫表名（最佳實踐）
• ORM 框架配置：Hibernate hibernate.globally_quoted_identifiers=true、MyBatis 結果映射指定小寫
• 視圖/同義詞：為大寫表名創建小寫視圖（維護成本高）

驗證修復

mysql> SHOW VARIABLES LIKE 'lower_case_table_names';
+------------------------+-------+
| Variable_name          | Value |
+------------------------+-------+
| lower_case_table_names | 1     |
+------------------------+-------+

mysql> SELECT * FROM TB_XXX;  -- 大寫查詢
-- 應正常返回數據