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 里有一行同名参数，后者会生效。动手前先理清实际加载链。