mysql 5.6 升级到 8.0 必须分步(先升至 5.7.26+),my.cnf 需彻底清理废弃参数(如 query_cache_type、slave_*、innodb_use_sys_malloc、no_auto_create_user)并显式添加新参数(default_authentication_plugin=mysql_native_password、character-set-server=utf8mb4 等),否则启动失败或连接报错。

MySQL 5.6 升级到 8.0 不能直接改配置文件就启动,必须先升到 5.7.26+,再重装 8.0;my.cnf 不是“微调”,而是要删旧参数、加新参数、改默认行为——漏一项就可能启动失败或连接报错。
哪些 5.6/5.7 的参数在 8.0 中已彻底失效?
MySQL 8.0 启动时会直接拒绝识别被移除的参数,日志里报 unknown variable 就卡死。必须手动清理:
-
query_cache_type和query_cache_size:查询缓存已完全删除,这两行必须删掉 -
slave_skip_errors、slave_exec_mode等所有slave_*开头的参数:全部换成replica_*形式(如replica_skip_errors) -
innodb_use_sys_malloc:强制禁用,保留会报错 - 注释掉但未删除的
old_passwords=1或sql_mode=NO_AUTO_CREATE_USER:这些在 8.0 已废弃,即使注释也可能触发兼容性警告
哪些新参数必须显式添加?
不加不是“功能缺失”,而是服务无法被旧客户端连接,或业务 SQL 直接报错:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
default_authentication_plugin=mysql_native_password:宝塔默认用caching_sha2_password,PHP 7.3、WordPress 5.7、Discuz! X3.4 等全连不上,必须设为mysql_native_password -
character-set-server=utf8mb4和collation-server=utf8mb4_unicode_ci:5.6 默认latin1,8.0 虽默认utf8mb4,但若旧配置里没显式写,升级后老表仍可能沿用utf8(3 字节),存 Emoji 或生僻字就乱码 -
skip_log_bin(仅升级过程中临时加):避免mysql_upgrade类操作写入 binlog,导致从库执行失败
为什么不能只靠 mysqld --validate-config 检查?
这个命令只校验语法和参数存在性,不验证实际行为是否符合预期。比如:
- 它不会告诉你
explicit_defaults_for_timestamp设为OFF会导致 TIMESTAMP 列默认值逻辑和 5.6 不一致 - 它不检查
sql_mode里是否还留着ONLY_FULL_GROUP_BY—— 这在 5.6 是可选,在 8.0 是默认开启,大量旧 GROUP BY 查询会直接报错 - 它读不到你实际加载的是哪个
my.cnf:宝塔环境下可能是/www/server/mysql/etc/my.cnf,也可能是/etc/my.cnf,得用mysqld --verbose --help | grep "Default options"确认路径
最容易被忽略的配置陷阱
不是参数写错,而是“旧配置还在、但含义变了”:
-
innodb_log_file_size值过大(比如 2G):8.0 启动时会尝试重建日志文件,若磁盘空间不足或权限不对,直接 hang 住不动 -
max_allowed_packet仍设为 1M:8.0 默认 64M,但若你从 5.6 搬来旧值,导入大视图或存储过程时会报Packets larger than max_allowed_packet are not allowed - 配置文件里混用 Unix 和 Windows 路径分隔符(如
datadir = C:\mysql\data):Linux 宝塔环境会当成无效路径,找不到数据目录
配置改完不是终点——必须用 mysqld --defaults-file=/www/server/mysql/etc/my.cnf --validate-config 预检,再启动,最后进库执行 SHOW VARIABLES LIKE 'default_authentication_plugin'; 和 SHOW VARIABLES LIKE 'character_set_server'; 看真实生效值。任何一项没对,都别急着导数据。










