MySQL修改表名不区分大小写配置方法

问题背景与目标

在开发过程中，如果应用程序在Windows上开发测试正常，迁移到Linux服务器后出现“Table doesn't exist”或数据查不到的错误，通常是因为MySQL在不同操作系统对标识符（如表名）的大小写处理策略不同。我们的目标是配置MySQL，使其像Windows那样忽略表名的大小写差异，提高代码的兼容性。

配置步骤

第1步：备份现有配置文件

目的：防止配置错误或意外情况导致数据库无法启动。 操作：在进行任何修改前，建议备份当前的MySQL配置文件。

# 备份 my.cnf (路径可能因发行版不同而略有差异，常见为 /etc/my.cnf 或 /etc/mysql/my.cnf)
cp /etc/my.cnf /etc/my.cnf.backup

第2步：编辑 MySQL 配置文件

入口：使用 root 权限文本编辑器打开 /etc/my.cnf。

sudo vi /etc/my.cnf
# 或者使用 nano
sudo nano /etc/my.cnf

动作：找到 [mysqld] 段落。如果不存在该段落，可能需要手动创建或确认配置文件结构。

重要参数：在 [mysqld] 下方添加或修改以下行：

[mysqld]
lower_case_table_names=1

• 0: 区分大小写。表名以磁盘上存储的方式保存，比较时区分大小写。这是 Linux/Unix 的默认值。
• 1: 不区分大小写。表名以小写形式存储在磁盘上，比较时不区分大小写。这是 Windows 和 macOS 的默认行为。
• 2: 不区分大小写（仅适用于某些文件系统）。表名以指定大小写存储在磁盘上，但在内存中比较时转换为小写。注意：此选项不支持在某些文件系统上的 InnoDB 表。

为了实现跨平台兼容且不区分大小写，我们通常选择设置为 1。

第3步：重启 MySQL 服务

目的：使配置文件中的更改生效。 操作：根据你的操作系统重启 MySQL 服务。

# CentOS / RedHat / Fedora
sudo systemctl restart mysqld

# Ubuntu / Debian
sudo systemctl restart mysql

注意事项与风险

已存在的数据影响：
lower_case_table_names 参数必须在 MySQL 首次初始化数据库 时设置正确。如果数据库已经存在且表名包含大写字符，直接修改此参数并重启会导致 MySQL 启动失败或数据无法访问。在这种情况下，需要先停止数据库，删除数据目录中的文件（务必先完整备份！），然后重新初始化数据库。

文件系统限制：
在 Unix/Linux 系统中，文件系统通常区分大小写，因此将表名强制转为小写存储是可行的，但需要注意原有数据的兼容性迁移问题。

验证配置

登录 MySQL 后，执行以下 SQL 命令检查当前设置：

SHOW VARIABLES LIKE 'lower_case_table_names';

如果输出结果为 1，则说明配置成功，现在 MySQL 将不区分表名大小写。