my.cnf语法错误导致MySQL启动失败，常见原因包括漏写等号、section名拼错、参数值误加引号等；可用mysqld --validate-config或--dry-run验证配置。
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 里有一行同名参数，后者会生效。动手前先理清实际加载链。
