直接替换镜像并迁移数据是最稳妥的MySQL容器升级方式，需先完整备份数据和配置，再拉取新镜像、用临时容器执行mysql_upgrade，最后启新容器；注意认证插件、SQL mode等兼容性变化。
直接替换镜像并迁移数据是最稳妥的 MySQL 容器升级方式，不建议在运行中的容器内执行 in-place 升级（如 apt upgrade），容易导致配置冲突、权限异常或数据损坏。
备份现有数据库再操作
升级前必须完整备份数据和配置：
- 用 mysqldump 导出所有库（含 mysql 系统库，如需保留用户和权限）：
docker exec -i mysql-old mysqldump -u root -p'yourpass' --all-databases > backup.sql - 同步挂载的配置文件（如 my.cnf）和初始化脚本（如 /docker-entrypoint-initdb.d/ 下的 .sql 文件）
- 确认 volume 路径（如 /var/lib/mysql 挂载点），避免误删数据目录
拉取新版本镜像并启动临时容器
选择官方支持的版本（如 8.0 → 8.4 或 5.7 → 8.0），注意查看MySQL 官方升级路径限制：
- 拉取新版镜像：docker pull mysql:8.4
- 启动一个临时容器，挂载原有数据卷 + 新版镜像，但不自动启动 MySQL：
docker run -d --name mysql-upgrade -v mysql-data:/var/lib/mysql -v $(pwd)/my.cnf:/etc/mysql/my.cnf:ro mysql:8.4 tail -f /dev/null - 进入容器手动执行升级命令：
docker exec -it mysql-upgrade mysql_upgrade -u root -p'yourpass'
切换到新版正式容器
验证升级无误后，停旧容器、启新容器：
- 停止旧容器：docker stop mysql-old && docker rm mysql-old
- 用相同网络、volume、环境变量启动新版容器：
docker run -d --name mysql-new -p 3306:3306 -v mysql-data:/var/lib/mysql -v $(pwd)/my.cnf:/etc/mysql/my.cnf:ro -e MYSQL_ROOT_PASSWORD=yourpass -d mysql:8.4 - 连接测试：mysql -h 127.0.0.1 -P 3306 -u root -p，检查版本（SELECT VERSION();）和关键表是否可读
注意兼容性与配置变更
新版 MySQL 常有默认行为调整，易引发应用报错：
- MySQL 8.0+ 默认认证插件改为 caching_sha2_password，老客户端可能连不上 —— 可在 my.cnf 中加 default_authentication_plugin=mysql_native_password，或创建用户时显式指定
- SQL mode 默认更严格（如 NO_ZERO_DATE），应用执行 INSERT 可能失败，需检查错误日志并调整 my.cnf 的 sql_mode
- 系统库结构变化（如 mysql.user 表字段），不要直接拷贝旧数据目录到新版容器，必须走 mysql_upgrade 流程
