my.cnf应优先放在/etc/my.cnf，Linux下加载顺序为/etc/my.cnf→/etc/mysql/my.cnf→$MYSQL_HOME/my.cnf→~/.my.cnf（仅客户端），高优先级路径覆盖低优先级，建议生产环境只保留单一配置文件以避免隐式覆盖。
my.cnf 文件该放哪？优先级混乱是配置失效的根源
生产环境里 my.cnf 没生效，十有八九不是写错了，而是根本没被读到。MySQL 启动时按固定顺序查找配置文件，高优先级路径会覆盖低优先级的同名项，你改了 /etc/my.cnf 却发现参数没变，很可能是因为 /etc/mysql/my.cnf 或 ~/.my.cnf 里有冲突配置。
查当前实际加载路径最可靠的方式是：
mysql --help | grep "Default options" -A 1
常见优先级（从高到低）：
/etc/my.cnf/etc/mysql/my.cnf-
SYSCONFDIR/my.cnf（编译时指定） $MYSQL_HOME/my.cnf-
~/.my.cnf（仅影响客户端）
生产环境强烈建议只用 /etc/my.cnf 或 /etc/mysql/my.cnf，删掉其他位置的配置文件，避免隐式覆盖。
必须显式设置的 5 个核心参数
默认值在生产环境基本不可用。比如 max_connections=151，高并发下连接池瞬间打满；innodb_buffer_pool_size 默认才 128MB，16GB 内存服务器只用了不到 1%，大量查询走磁盘。
关键参数要根据硬件和业务场景硬编码，不能依赖默认：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
innodb_buffer_pool_size：设为物理内存的 50–70%，专用 DB 服务器可设到 75%。例如 32GB 内存 →innodb_buffer_pool_size = 24G -
max_connections：预估峰值并发连接数，留 20% 余量。Web 应用常见 200–500；微服务集群可能需 1000+。 -
innodb_log_file_size：设为innodb_buffer_pool_size的 25% 左右（上限 2G）。太小导致频繁 checkpoint，太大延长崩溃恢复时间。 -
wait_timeout和interactive_timeout：设为 300–600 秒（5–10 分钟），避免空闲连接长期占用资源。 -
character_set_server和collation_server：强制设为utf8mb4和utf8mb4_unicode_ci，避免 emoji 和多语言乱码。
caching_sha2_password 认证插件引发的连接失败
MySQL 8.0 默认用 caching_sha2_password，但很多老应用、监控工具、甚至某些版本的 mysql-client 不支持它，报错 Plugin caching_sha2_password could not be loaded 或直接拒绝连接。
解决方式不是降级回 mysql_native_password（不推荐），而是针对性兼容：
- 对新用户：创建时明确指定插件：
CREATE USER 'app'@'%' IDENTIFIED WITH caching_sha2_password BY 'pwd'; - 对旧应用：临时允许其使用旧插件：
ALTER USER 'legacy_app'@'%' IDENTIFIED WITH mysql_native_password BY 'pwd'; - 全局禁用（仅测试环境）：
default_authentication_plugin = mysql_native_password（不建议生产启用）
注意：修改认证方式后必须执行 FLUSH PRIVILEGES;，且部分客户端需升级驱动（如 JDBC 8.0+）。
配置后必须验证的三件事
改完 my.cnf 重启 MySQL 只是第一步。不验证等于没配：
- 确认参数已生效：
SHOW VARIABLES LIKE 'innodb_buffer_pool_size';，对比输出值与配置文件是否一致 - 检查错误日志：
tail -f /var/log/mysqld.log，启动时若有WARNING或ERROR（如日志文件大小不匹配），说明配置有冲突或语法错误 - 验证连接行为：用目标客户端（如应用代码、Prometheus exporter）连一次，别只用
mysql -u root -p测试——它可能走的是 socket，而应用走的是 TCP，权限和插件策略可能不同
最容易被忽略的是日志路径权限和 SELinux 上下文。CentOS/RHEL 上若 log-error = /var/log/mysqld.log，但 mysqld 用户无写入权限，服务会静默失败——看 systemd 状态 systemctl status mysqld 才能发现。
