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

做一个积极的人

编码、改bug、提升自己

我有一个乐园，面向编程，春暖花开！

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大小敏感很了解，以下内容可以跳过….）

于是就利用搜索引擎，发现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。

lowercasefile_system

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

lowercasetable_names

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

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

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

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，则不应将lowercasetable_names设置为0。

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

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

02 注意事项

修改lowercasetable_names导致的常见不良隐患： 如果在lower_case_table_names=0时，创建了含有大写字母的库表，改为lower_case_table_names=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大小写敏感问题lowercasetablenames & lowercasefilesystem

---

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

---

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

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

© 每天都在变得更好的阿飞云