直接替换镜像并复用已有数据卷是唯一推荐的MySQL升级路径；需确保数据卷正确挂载至/var/lib/mysql，检查挂载类型与权限，用临时容器执行mysql_upgrade，再以一致环境参数启动新容器。
直接替换镜像 + 复用已有数据卷，是唯一推荐的升级路径。在容器内执行 apt upgrade 或就地运行 mysql_upgrade 而不换镜像，大概率导致启动失败或权限异常。
确认数据卷是否已挂载到 /var/lib/mysql
这是整个升级能成功的前提。如果启动容器时没加 -v 参数，或者挂载路径不是 /var/lib/mysql（比如错写成 /data），那数据根本不在卷里，升级前就会丢数据。
- 检查当前容器挂载：运行
docker inspect mysql-old | jq '.[0].Mounts'，确认"Destination": "/var/lib/mysql"且"Type": "volume"或绑定宿主机绝对路径 - 常见错误：用
-v /mydata:/var/lib/mysql但宿主机/mydata权限不对（MySQL 8.4 默认以用户mysql运行，UID 999），会导致启动卡在 “Initializing database” - 若用命名卷（如
mysql-data），可通过docker volume inspect mysql-data查看实际存储位置，无需手动干预权限
拉取新镜像并用临时容器跑 mysql_upgrade
新版 MySQL 镜像启动时会自动检测数据目录版本并尝试升级，但官方明确建议先手动执行 mysql_upgrade，尤其跨大版本（如 5.7 → 8.0）时，避免因认证插件（caching_sha2_password）、默认 SQL mode 变更引发连接失败。
Mysql Skill 1.0.0 (3)
下载
MySQL 数据库管理技能，能够通过自然语言查询和管理数据库，支持 SELECT/INSERT/UPDATE/DELETE、表管理、备份恢复等操作。当用户提及 MySQL、数据库查询、建表或数据备份时使用此技能。
- 启动临时容器：用新镜像 + 原数据卷 + 不自动启动 MySQL，例如：
docker run -d --name mysql-upgrade -v mysql-data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=yourpass mysql:8.4 tail -f /dev/null - 进入执行升级：
docker exec -it mysql-upgrade mysql_upgrade -u root -p'yourpass'；若报错 “Access denied”，说明旧密码哈希格式不兼容，需先用旧镜像容器重置 root 密码为mysql_native_password插件 - 升级后不要删掉这个临时容器——它已把系统表结构更新完毕，新正式容器启动时会跳过初始化流程
停旧容器、启新容器时的关键参数必须一致
环境变量、端口映射、网络模式、挂载点这四项只要有一项不同，就可能让新容器无法读取原有数据，或启动后数据库“空了”。
- 必须复用的配置包括：
-e MYSQL_ROOT_PASSWORD（否则新容器会重新初始化并生成随机密码）、-v mysql-data:/var/lib/mysql（不能漏掉冒号两边的路径）、--network（如果旧容器在自定义网络中） - 可安全调整的项：镜像标签（
mysql:8.4）、容器名（--name mysql-new）、日志驱动、资源限制 - 特别注意：MySQL 8.4 默认启用
require_secure_transport=ON，若客户端不支持 SSL 连接，需在my.cnf中显式关闭，或启动时加-e MYSQL_ALLOW_EMPTY_PASSWORD=yes（仅测试环境）
最易被忽略的是配置文件兼容性——比如旧版 my.cnf 里写了 default_authentication_plugin=mysql_native_password，而 MySQL 8.4 已弃用该配置项，启动时会报 warning 并忽略，结果 root 用户突然连不上。升级前务必对照 MySQL 官方文档检查配置项是否仍有效。
