my.cnf 语法错误导致 MySQL 启动失败
MySQL 启动时直接报错退出，日志里出现
unknown variable、
invalid option或
Failed to parse config file，基本是
my.cnf（或
my.ini）存在语法问题。最常见的是：漏写等号、用空格代替等号、在值里误加引号、section 名拼错（比如写成
[mysqldd]）、或用了新版本才支持的参数但 MySQL 版本太老。 用
mysqld --defaults-file=/etc/my.cnf --verbose --help检查配置加载是否成功（不启动服务，只解析）；失败时会明确指出哪一行出错 确认 section 头格式为
[mysqld]、
[client]等，不能有空格或注释混在中括号内 所有参数必须形如
innodb_buffer_pool_size = 2G，等号前后可有空格，但不能用冒号或省略等号 字符串值一般不需要引号（如
log_error = /var/log/mysqld.log），加了反而可能被当字面量解析失败
参数值超出范围或类型不匹配
MySQL 能读通配置，但启动后立刻崩溃、报
Aborted，或运行中出现
Out of memory、
Invalid argument，常因参数设得不合理。例如把
innodb_buffer_pool_size设成大于物理内存，或把
max_connections设到 10 万却没调高系统文件描述符限制。 检查关键参数是否符合当前版本文档要求：比如
innodb_log_file_size在 MySQL 5.6+ 不允许动态修改，且总和不能超过 512GB 用
mysql --help --verbose | grep "Default options"查看默认配置路径和顺序，避免多个
my.cnf文件互相覆盖 对内存类参数（
innodb_buffer_pool_size、
key_buffer_size）留至少 20% 给 OS 和其他进程；数值单位统一用
K/
M/
G，别混用小写
m（MySQL 5.7+ 不识别） 修改
open_files_limit前，先确认系统级限制：
ulimit -n，否则 MySQL 会静默降级使用默认值
配置生效但行为异常：参数被忽略或未生效
执行
SHOW VARIABLES发现某参数还是旧值，比如改了
wait_timeout却没变，说明该参数没被正确加载，或者被更高优先级配置覆盖。 MySQL 加载配置顺序是：
/etc/my.cnf→
/etc/mysql/my.cnf→
SYSCONFDIR/my.cnf→
$MYSQL_HOME/my.cnf→
~/.my.cnf；后面文件会覆盖前面同名参数 确认你编辑的是真正被读取的那个文件：运行
mysqld --verbose --help | grep "Default options"，看输出中列出的路径 某些参数只在特定 section 生效：比如
innodb_buffer_pool_size必须在
[mysqld]下，写在
[client]或
[mysql]里完全无效 部分参数需重启生效（如
innodb_log_file_size），有些可动态设置（如
max_connections），但动态设置只影响本次运行，不写入配置文件
如何安全验证修改后的配置
别直接重启生产库。先做最小化验证，避免服务中断。
用mysqld --defaults-file=/etc/my.cnf --validate-config（MySQL 5.7.21+）快速校验语法和参数合法性 若版本较老，用
mysqld --defaults-file=/etc/my.cnf --dry-run --verbose --help > /dev/null，返回码为 0 表示无硬性错误 启动一个临时实例测试：
mysqld --defaults-file=/tmp/test.cnf --datadir=/tmp/mysql-test --port=3307 --skip-networking，连上去跑
SHOW VARIABLES LIKE 'xxx';确认值正确 特别注意
basedir、
datadir、
socket这些路径参数，一旦写错会导致找不到数据或套接字文件，报
Can't connect to local MySQL server
mysqld --defaults-file=/etc/my.cnf --validate-config # 如果输出 "Validated configuration" 且返回码为 0，说明语法和基础参数没问题
配置里最容易被忽略的是路径权限和多文件叠加效应——比如你改了
/etc/my.cnf，但
/etc/mysql/conf.d/override.cnf里有一行同名参数，后者会生效。动手前先理清实际加载链。
