MySQL 配置文件添加参数后服务起不来了

如何正确地向数据库添加配置参数。

作者：王雅蓉，DBA，负责 MySQL 日常问题处理和 DMP 产品维护。

爱可生开源社区出品，原创内容未经授权不得随意使用，转载请联系小编并注明来源。

本文约 1000 字，预计阅读需要 3 分钟。

背景信息

客户要将数据库数据迁移到 DMP 平台上，需要根据源库的配置修改相应参数（例：lower_case_table_names=0），但发现在配置文件添加好参数后数据库起不来了。

mysql-error.log

...........
2023-08-23T15:22:01.554471+08:00 0 [Note] Plugin 'FEDERATED' is disabled.
2023-08-23T15:22:01.557909+08:00 0 [Note] Semi-sync replication initialized for transactions.
2023-08-23T15:22:01.557926+08:00 0 [Note] Semi-sync replication enabled on the master.
2023-08-23T15:22:01.557976+08:00 0 [ERROR] unknown variable 'lower_case_table_names<C2>= 0'
2023-08-23T15:22:01.557982+08:00 0 [Note] Starting ack receiver thread
2023-08-23T15:22:01.557987+08:00 0 [ERROR] Aborting
 
2023-08-23T15:22:01.558028+08:00 0 [Note] Binlog end
............

分析

因为查看 MySQL 的 error log 中显示参数问题，于是就将添加的参数注释掉，发现注释后可以正常启动数据库，于是就定位到参数上。

因为该参数是从文档上直接粘贴出来的，于是又手打出了相同的参数，发现可以正常重启。

确定了是由于粘贴的参数出现了问题。

[root@b 4444]# cat  /opt/mysql/etc/4444/my.cnf |tail -n 3
#lower_case_table_names = 0
 
lower_case_table_names = 0
[root@b 4444]# systemctl restart mysqld_4444.service

本地复现

将参数粘贴到配置文件中后重启数据库。

[root@b ~]# cat  /opt/mysql/etc/4444/my.cnf |tail -n 2
lower_case_table_names = 0
 
[root@b ~]# systemctl restart mysqld_4444.service
Job for mysqld_4444.service failed because the control process exited with error code. See "systemctl status mysqld_4444.service" and "journalctl -xe" for details.

#mysql-error.log
......
2023-08-23T16:03:15.775792+08:00 0 [Note] Plugin 'FEDERATED' is disabled.
2023-08-23T16:03:15.778066+08:00 0 [Note] Semi-sync replication initialized for transactions.
2023-08-23T16:03:15.778082+08:00 0 [Note] Semi-sync replication enabled on the master.
2023-08-23T16:03:15.778119+08:00 0 [ERROR] unknown variable 'lower_case_table_names<C2>= 0'
2023-08-23T16:03:15.778125+08:00 0 [ERROR] Aborting
 
2023-08-23T16:03:15.778120+08:00 0 [Note] Starting ack receiver thread
2023-08-23T16:03:15.778143+08:00 0 [Note] Binlog end
......

在配置文件中手打该参数并重启数据库。

[root@b ~]# cat  /opt/mysql/etc/4444/my.cnf |tail -n 2
#lower_case_table_names = 0
lower_case_table_names = 0
[root@b ~]# systemctl restart mysqld_4444.service
[root@b ~]# ps -ef |grep mysqld
actiont+ 20393     1  3 16:07 ?        00:00:00 /opt/mysql/base/5.7.25/bin/mysqld --defaults-file=/opt/mysql/etc/4444/my.cnf --daemonize --pid-file=/opt/mysql/data/4444/mysqld.pid --user=actiontech-mysql --socket=/opt/mysql/data/4444/mysqld.sock --port=4444
root     23821  2821  0 16:07 pts/0    00:00:00 grep --color=auto mysqld

可得出确实是粘贴的参数格式有问题，来看一下是由于什么问题引起的。

方法 1：hexdump

hexdump 是 Linux 下的一个二进制文件查看工具，它可以将二进制文件转换为 ASCII、八进制、十进制、十六进制格式进行查看。默认显示方式是十六进制。

通过对比可以知道是前一个参数“=”前后的空格为特殊字符。

302 240：为文档或网页中的不间断空格，是 UTF-8 的字符不与 ASCII 兼容，所以执行参数出现报错。

不间断空格和普通空格的区别是：页面展示涉及到换行的时候，普通空格位置会截断换行，而这个特殊空格则不会截断。

方法 2：od

od 用于将指定文件内容以八进制、十进制、十六进制、浮点格式或 ASCII 编码字符方式显示，通常用于显示或查看文件中不能直接显示在终端的字符。od 默认显示方式是八进制。

同样通过对比可以知道是前一个参数“=”前后的空格为特殊字符。

302 240：同上。

方法 3：编辑器

这里以 Sublime Text 为例。将添加参数粘贴到 Sublime Text 编辑器上，使用 UTF-8 编码打开，显示粘贴的参数确实有特殊字符。

通过 <0xa0> 也可知该符号为 Unicode 字符中的不间断空格。

总结

在日常运维中，如果需要在配置文件中添加参数，最好不要直接从文档或网页上粘贴参数。建议通过 DMP 等运维平台修改参数或者通过手打来添加或修改参数。

如果需要粘贴大量参数，最好重启前检查一下粘贴参数的编码中是否包含特殊字符。