一个因MySQL大小写敏感导致的问题

客官°小女子只卖身不卖艺 2022-01-17 09:35 231阅读 0赞

> 做一个积极的人
> 
> 编码、改bug、提升自己
> 
> 我有一个乐园，面向编程，春暖花开！

### 文章目录 ###

*   *  00 MYSQL对大小写敏感
     *  01 一个表字母大小故事
     *   *  lower\_case\_file\_system
         *  lower\_case\_table\_names
     *  02 注意事项
     *  03 总结
     *  04 参考资料

## 00 MYSQL对大小写敏感 ##

见字如面，见标题知内容。你有遇到过因为MYSQL对大小写敏感而被坑的体验吗？

之前看过阿里巴巴Java开发手册，在MySql建表规约里有看到：

> 【强制】表名、字段名必须使用小写字母或数字 ， 禁止出现数字开头，禁止两个下划线中间只  
> 出现数字。数据库字段名的修改代价很大，因为无法进行预发布，所以字段名称需要慎重考虑。

**说明： MySQL 在 Windows 下不区分大小写，但在 Linux 下默认是区分大小写**。因此，数据库名、  
表名、字段名，都不允许出现任何大写字母，避免节外生枝。

> 正例： aliyun \_ admin ， rdc \_ config ， level 3\_ name  
> 反例： AliyunAdmin ， rdcConfig ， level *3* name

如果没有真正遇到过类似的问题，有时候干巴巴的看这些规约体会不深，理解起来似懂非懂，并且也只是死记硬背而已。

## 01 一个表字母大小故事 ##

最近自己在鼓捣一个项目玩玩，在自己本机上开发和测试过程中一直没有问题，但是部署到Linux服务器上后，发现有报错，日志信息大概是：

> MySQLSyntaxErrorException: Table ‘kytu.tb\_sutyHo’ doesn’t exist

出现了问题，有点郁闷，本地开发好好的，怎么部署服务器就不行了。有鬼…不过莫慌。看着错误提示很明显，不就是`tb_sutyHo` 表不存在吗！

①于是我不慌不忙打开nv（navicat），查看这个表在不在，一看还真在，数据库中显示的`tb_sutyho` ，不过h是小写；

②查看代码发现代码中还真把表名写成`tb_sutyHo` ,就一个h写成大写H了。

问题找到了，原来是不小心写SQL的时候没有写对表名，改一下表名就搞定了，功能也一切正常了。一般情况下故事到这里也就应该结束了？问题找到了，也修复了，万事大吉了，稍后就可以吃鸡了。

对于不会玩吃鸡的我，到这里并没有结束，找到问题和解决问题的确很重要，但是找到问题出现的根源更重要，这样就能在下次规避此类问题，作为一个程序员不要两次掉入一个坑里。

我在想这个问题，本地Window环境怎么就一直没有出现这个报错提示呢？非要等我部署服务器才出现，这到底是什么问题？（如果你对Mysql大小敏感很了解，以下内容可以跳过…）

![format_png][]

于是就利用搜索引擎，发现Mysql中控制数据库名和表名的大小写敏感由参数`lower_case_table_names`控制。

在本机Window环境查看如下：

mysql> show variables like '%case%';
    +------------------------+-------+
    | Variable_name          | Value |
    +------------------------+-------+
    | lower_case_file_system | ON    |
    | lower_case_table_names | 1     |
    +------------------------+-------+

在Linux服务器查看如下：

mysql> show variables like '%case%';
    +------------------------+-------+
    | Variable_name          | Value |
    +------------------------+-------+
    | lower_case_file_system | OFF    |
    | lower_case_table_names | 0     |
    +------------------------+-------+

从上面的结果已经可以看出不同了，然而对这两个参数还没有感觉，不知道具体是什么意思。

在介绍`lower_case_table_names`的时候，顺便也说一下`lower_case_file_system`。

### [lower\_case\_file\_system][lower_case_file_system] ###

此变量描述数据目录所在的文件系统上文件名的区分大小写。 OFF表示文件名区分大小写，ON表示它们不区分大小写。此变量是只读的，因为它反映了文件系统属性并设置它对文件系统没有影响。

### [lower\_case\_table\_names][lower_case_table_names] ###

该参数为静态，可设置为0、1、2。

**0 --大小写敏感。（Unix，Linux默认）**  
创建的库表将原样保存在磁盘上。如create database TeSt;将会创建一个TeSt的目录，create table AbCCC …将会原样生成AbCCC.frm。  
SQL语句也会原样解析。

**1 --大小写不敏感。（Windows默认）**  
创建的库表时，MySQL将所有的库表名转换成小写存储在磁盘上。  
SQL语句同样会将库表名转换成小写。  
如需要查询以前创建的Test\_table（生成Test\_table.frm文件），即便执行select \* from Test\_table，也会被转换成select \* from test\_table，致使报错表不存在。

**2 --大小写不敏感（OS X默认）**  
创建的库表将原样保存在磁盘上。  
但SQL语句将库表名转换成小写。

> On Windows the default value is 1. On macOS, the default value is 2. On Linux, a value of 2 is not supported; the server forces the value to 0 instead.

在Windows上，默认值为1。在macOS上，默认值为2。在Linux上不支持值2;服务器强制该值为0。

并且官网也提示说：如果在数据目录驻留在不区分大小写的文件系统（例如Windows或macOS）上的系统上运行MySQL，则**不应将lower\_case\_table\_names设置为0**。

我自己在我的window10环境尝试设置`lower_case_table_names`为0的时候，MySQL的服务怎么也启动不能，启动服务报错。windows系统对大小写不敏感，会认为名称是相同的，见下图：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9hZmx5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70]

注： 如果要修改`lower_case_table_names`这个值，windows下修改my.ini ，Linux下修改my.cnf配置文件，需要重启服务,具体操作可以自行上网找资料。

## 02 注意事项 ##

**修改lower\_case\_table\_names导致的常见不良隐患**：  
如果在`lower_case_table_names=0`时，创建了含有大写字母的库表，改为`lower_case_table_names=1`后，则会无法被查到。

![format_png 1][]

首先设置`lower_case_table_names=0`

CREATE TABLE `Student` (
      `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
      `name` varchar(25) NOT NULL,
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    
    show tables;
    +----------------+
    | Tables_in_aflyun |
    +----------------+
    | Student           |
    +----------------+

再设置`lower_case_table_names=1`,执行查询，不管表名是大写还是小写，都提示表不存在。

mysql> select * from Student;
    1146 - Table 'aflyun.Student' doesn't exist mysql> select * from student; 1146 - Table 'aflyun.student' doesn't exist

**解决方法**：如果要将默认的`lower_case_tables_name`为0设置成1，**需先将已经存在的库表名转换为小写**。

针对仅表名存在大写字母的情况：  
①、`lower_case_tables_name=0`时，执行`rename table`成小写。  
②、设置`lower_case_tables_name=1`，重启生效。

针对库名存在大写字母的情况：  
①、`lower_case_tables_name=0`时，使用`mysqldump`导出，并删除老的数据库。  
②、设置`lower_case_tables_name=1`，重启生效。  
③、导入数据至实例，此时包含大写字母的库名已转换为小写。

## 03 总结 ##

有了踩坑的经验，对开头说的阿里Mysql规约理解更加深入了。操作系统不同导致大小写敏感不一致。我们在开发时，应该按大小写敏感的原则去开发，这样可以使开发的程序兼容不同的操作系统。因此，建议在开发测试环境下把`lower_case_table_names`的值设为0，便于在开发中就严格控制代码大小写敏感，提高代码的兼容和严谨。

## 04 参考资料 ##

[MySQL大小写敏感问题lower\_case\_table\_names & lower\_case\_file\_system][MySQL_lower_case_table_names _ lower_case_file_system]

--------------------

**谢谢你的阅读，如果您觉得这篇博文对你有帮助，请点赞或者喜欢，让更多的人看到！祝你每天开心愉快！**

--------------------

**不管做什么，只要坚持下去就会看到不一样！在路上，不卑不亢!**

[博客首页 : https://aflyun.blog.csdn.net/][_ https_aflyun.blog.csdn.net]

**愿你我在人生的路上能都变成最好的自己，能够成为一个独挡一面的人**  
![format_png 2][]

[format_png]: /images/20220117/54e09e47fcbb482ca46450abc61bac52.png
[lower_case_file_system]: https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_lower_case_file_system
[lower_case_table_names]: https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_lower_case_table_names
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9hZmx5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70]: /images/20220117/2fc2f212953744c190717c78d0196761.png
[format_png 1]: /images/20220117/7545230884c44cd08c9d7aabf6a92d37.png
[MySQL_lower_case_table_names _ lower_case_file_system]: https://www.linuxidc.com/Linux/2018-01/150696.htm
[_ https_aflyun.blog.csdn.net]: https://aflyun.blog.csdn.net/
[format_png 2]: /images/20220117/c4045dcdd6814f61a352ec81ab984294.png